Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

2.9 KB
Raw Blame
//
//  Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//

package handler

import (
	"errors"
	"net/http"
	"strings"

	"ragflow/internal/common"
	"ragflow/internal/service"

	"github.com/gin-gonic/gin"
	"go.uber.org/zap"
)

// jsonInternalError logs the original error while returning a generic message
// to avoid exposing internal implementation details in API responses.
func jsonInternalError(c *gin.Context, err error) {
	common.Warn("handler internal error",
		zap.Error(err),
		zap.String("method", c.Request.Method),
		zap.String("path", c.Request.URL.Path),
	)
	common.RespondError(c, common.CodeServerError, common.CodeServerError.Message())
}

// HandleNoRoute handles requests to undefined routes
func HandleNoRoute(c *gin.Context) {
	// Python parity: requests that resolve to a Werkzeug MethodNotAllowed in
	// the Python API render as HTTP 200 / code 100 with the exception's repr()
	// as the message. gin instead falls through to NoRoute, so emit the same
	// body here to keep the error paths byte-for-byte aligned.
	if isOAuthLoginNoRoute(c) ||
		(c.Request.Method == http.MethodPost && c.Request.URL.Path == "/api/v1/chats//sessions") ||
		(c.Request.Method == http.MethodPatch && strings.HasSuffix(c.Request.URL.Path, "/sessions/")) {
		common.RespondError(c, common.CodeExceptionError, "<MethodNotAllowed '405: Method Not Allowed'>")
		return
	}

	// Log the request details on server side
	common.Logger.Warn("The requested URL was not found",
		zap.String("method", c.Request.Method),
		zap.String("path", c.Request.URL.Path),
		zap.String("query", c.Request.URL.RawQuery),
		zap.String("remote_addr", c.ClientIP()),
		zap.String("user_agent", c.Request.UserAgent()),
	)

	// Return JSON error response
	c.JSON(http.StatusNotFound, gin.H{
		"code":    404,
		"message": "Not Found: " + c.Request.URL.Path,
		"error":   "Not Found",
	})
}

// IngestionTaskErrorCode maps ingestion-task service errors to common.ErrorCode
// for HTTP responses.
func IngestionTaskErrorCode(err error) common.ErrorCode {
	var transitionErr *service.InvalidTaskTransitionError
	if errors.As(err, &transitionErr) {
		return common.CodeConflict
	}
	var conflictErr *service.TaskStatusConflictError
	if errors.As(err, &conflictErr) {
		return common.CodeConflict
	}
	if errors.Is(err, common.ErrTaskNotFound) {
		return common.CodeNotFound
	}
	return common.CodeExceptionError
}