🐛 fix(handlers): 统一错误响应为安全 JSON 并补参数校验

- 新增 respondError:JSON 安全编码,客户端错误返回 400,服务端错误返回 500
- 收编 book/content/media/category 中 13 处 fmt.Fprintf 内联 JSON,修复错误信息含引号/换行时产出非法 JSON 的问题
- search/detail/catalog/multi-detail/content/multi-content/item-summary/audio/video 补必需参数校验,缺参返回 400
- search 的 offset/tab_type 非数字时返回 400,不再静默置 0
- 补齐 multi-detail/multi-content 的请求统计计数
- 新增 error_response_test.go:3 个测试锁定错误响应行为
- openapi.yaml 新增 ServerError 响应组件,15 个业务接口补 400/500 响应定义

BREAKING CHANGE: 业务接口错误不再返回 HTTP 200,缺参返回 400,上游失败返回 500
This commit is contained in:
chenxin committed 2026-09-29 22:47:01 +08:00
1 parent 1eccebedf9
commit d1774a3902
7 files changed
+209 -52

No files matched your search

+25 -13
View File
@@ -12,9 +12,13 @@ func HandleContent(w http.ResponseWriter, r *http.Request) {
incrementStat("total", "content")
w.Header().Set("Content-Type", "application/json; charset=utf-8")
// 从查询参数获取item_id
itemID := r.URL.Query().Get("item_id")
params, err := validateParams(r, "item_id")
if err != nil {
respondError(w, err.Error(), true)
return
}
itemID := params["item_id"]
// 获取URL参数(支持动态覆盖配置)
textMode := r.URL.Query().Get("text_mode") // 1=纯文本模式
imageMode := r.URL.Query().Get("image_mode") // 0=移除图片, 1=保留图片
@@ -22,7 +26,7 @@ func HandleContent(w http.ResponseWriter, r *http.Request) {
result, err := fqapi.HandleGetContent(itemID, textMode, imageMode)
if err != nil {
fmt.Fprintf(w, `{"code": -1, "msg": "获取内容失败: %s"}`, err.Error())
respondError(w, "获取内容失败: "+err.Error(), false)
return
}
@@ -51,17 +55,22 @@ func HandleContent(w http.ResponseWriter, r *http.Request) {
// HandleMultiContent 批量内容处理
func HandleMultiContent(w http.ResponseWriter, r *http.Request) {
incrementStat("total", "content")
w.Header().Set("Content-Type", "application/json; charset=utf-8")
bookID := r.URL.Query().Get("book_id")
itemIDs := r.URL.Query().Get("item_ids")
params, err := validateParams(r, "book_id", "item_ids")
if err != nil {
respondError(w, err.Error(), true)
return
}
textMode := r.URL.Query().Get("text_mode")
imageMode := r.URL.Query().Get("image_mode")
ignoreFailed := r.URL.Query().Get("ignore_failed")
result, err := fqapi.HandleMultiContent(itemIDs, bookID, textMode, imageMode, ignoreFailed)
result, err := fqapi.HandleMultiContent(params["item_ids"], params["book_id"], textMode, imageMode, ignoreFailed)
if err != nil {
fmt.Fprintf(w, `{"code": -1, "msg": "批量获取内容失败: %s"}`, err.Error())
respondError(w, "批量获取内容失败: "+err.Error(), false)
return
}
@@ -72,12 +81,15 @@ func HandleMultiContent(w http.ResponseWriter, r *http.Request) {
func HandleItemSummary(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
bookID := r.URL.Query().Get("book_id")
itemIDs := r.URL.Query().Get("item_ids")
result, err := fqapi.HandleItemSummary(itemIDs, bookID)
params, err := validateParams(r, "book_id", "item_ids")
if err != nil {
fmt.Fprintf(w, `{"code": -1, "msg": "获取章节摘要失败: %s"}`, err.Error())
respondError(w, err.Error(), true)
return
}
result, err := fqapi.HandleItemSummary(params["item_ids"], params["book_id"])
if err != nil {
respondError(w, "获取章节摘要失败: "+err.Error(), false)
return
}