2026-08-28 15:06:01 +08:00
package httpx
import (
"encoding/json"
2026-10-20 16:36:26 +08:00
"errors"
"fmt"
2026-08-28 15:06:01 +08:00
"net/http"
2026-11-10 23:42:50 +08:00
"strings"
2026-10-20 16:36:26 +08:00
"bj_power_mes/internal/verr"
2026-08-28 15:06:01 +08:00
)
// Resp 统一返回结构
type Resp struct {
Code int `json:"code"`
Message string `json:"message"`
Data any `json:"data,omitempty"`
}
func writeJSON ( w http . ResponseWriter , status int , body any ) {
w . Header (). Set ( "Content-Type" , "application/json; charset=utf-8" )
w . WriteHeader ( status )
_ = json . NewEncoder ( w ). Encode ( body )
}
// Ok 成功
func Ok ( w http . ResponseWriter , data any ) {
writeJSON ( w , http . StatusOK , Resp { Code : 0 , Message : "success" , Data : data })
}
// OkCode 成功但自定义 message
func OkMessage ( w http . ResponseWriter , message string , data any ) {
writeJSON ( w , http . StatusOK , Resp { Code : 0 , Message : message , Data : data })
}
2026-11-17 06:41:41 +08:00
// friendlyMessage 把数据库底层技术错误(pq: / SQLSTATE / 约束冲突等)统一转成用户能看懂的业务提示。
2026-11-10 23:42:50 +08:00
// 覆盖所有出口(Fail / FailHTTP / FailErr / BadRequest / InternalError),
2026-11-17 06:41:41 +08:00
// 免得某个 handler 直接 err.Error() 就把 "duplicate key violates unique constraint..." 原样弹给用户。
// 分层:①已知唯一约束(23505)按表名给精确对象名 → ②其他已知 SQLSTATE 按类型给友好文案 →
// ③未识别的 pq:/SQLSTATE 兜底给通用提示(附原始错误便于排查)→ ④纯业务文本原样返回(不误伤)。
2026-11-10 23:42:50 +08:00
func friendlyMessage ( raw string ) string {
if raw == "" {
return raw
}
lower := strings . ToLower ( raw )
2026-11-17 06:41:41 +08:00
// ① 唯一约束冲突(23505):按约束/表名给更具体的业务对象名
2026-11-10 23:42:50 +08:00
isDup := strings . Contains ( lower , "23505" ) ||
strings . Contains ( lower , "duplicate key" ) ||
strings . Contains ( lower , "violates unique constraint" ) ||
strings . Contains ( lower , "重复键" ) ||
strings . Contains ( lower , "重复键违反唯一约束" )
2026-11-17 06:41:41 +08:00
if isDup {
switch {
case strings . Contains ( lower , "sys_config" ):
return "该配置项已存在,请勿重复添加(同名模板/配置只能保存一次)"
case strings . Contains ( lower , "station" ):
return "该工位已存在,请勿重复添加(工位号不能重复)"
case strings . Contains ( lower , "work_order" ) || strings . Contains ( lower , "workorder" ):
return "该产品工号已存在,请勿重复添加"
case strings . Contains ( lower , "workpiece" ) || strings . Contains ( lower , "_sn" ):
return "该产品序号(SN)已存在,请勿重复添加"
case strings . Contains ( lower , "material" ) || strings . Contains ( lower , "product_type" ):
return "该物料已存在,请勿重复添加(图号不能重复)"
case strings . Contains ( lower , "daily_plan" ):
return "该工单在这天已有排产,请勿重复添加"
case strings . Contains ( lower , "user" ) || strings . Contains ( lower , "username" ):
return "该账号已存在,请勿重复添加"
default :
return "该记录已存在,请勿重复添加(同名或同编号的记录只能保存一次)"
}
2026-11-10 23:42:50 +08:00
}
2026-11-17 06:41:41 +08:00
// ② 其他已知 SQLSTATE / 约束类型,按错误性质给友好提示 + 怎么办
2026-11-10 23:42:50 +08:00
switch {
2026-11-17 06:41:41 +08:00
case strings . Contains ( lower , "23503" ) || strings . Contains ( lower , "violates foreign key constraint" ):
return "保存失败:该记录已被其他单据引用,不能删除或改为无效值。请先处理引用它的单据再重试"
case strings . Contains ( lower , "23502" ) || strings . Contains ( lower , "violates not-null constraint" ) || strings . Contains ( lower , "null value in column" ):
return "保存失败:有必填内容未填。请检查带星号的必填项后重试"
case strings . Contains ( lower , "22001" ) || strings . Contains ( lower , "value too long" ) || strings . Contains ( lower , "character varying" ):
return "保存失败:某项内容超过允许长度。请缩短名称/备注后重试"
case strings . Contains ( lower , "22003" ) || strings . Contains ( lower , "numeric value out of range" ):
return "保存失败:某项数字超出允许范围。请核对数量/数值后重试"
case strings . Contains ( lower , "22p02" ) || strings . Contains ( lower , "invalid input syntax" ) || strings . Contains ( lower , "invalid input syntax for type" ):
return "保存失败:某项数字或日期格式不正确。请检查录入内容后重试"
case strings . Contains ( lower , "23514" ) || strings . Contains ( lower , "violates check constraint" ):
return "保存失败:某项内容不符合业务规则取值。请核对选项后重试"
case strings . Contains ( lower , "40001" ) || strings . Contains ( lower , "deadlock detected" ):
return "保存失败:本次操作与其他操作冲突。请稍等片刻后重试"
case strings . Contains ( lower , "42p01" ) || strings . Contains ( lower , "relation" ) && strings . Contains ( lower , "does not exist" ):
return "保存失败:相关数据未就绪(表或结构不存在)。请通知维护人员初始化数据后再试"
case strings . Contains ( lower , "42703" ) || strings . Contains ( lower , "column" ) && strings . Contains ( lower , "does not exist" ):
return "保存失败:数据结构与程序版本不一致。请通知维护人员升级后再试"
case strings . Contains ( lower , "08006" ) || strings . Contains ( lower , "connection" ) && strings . Contains ( lower , "refused" ) || strings . Contains ( lower , "could not connect" ):
return "保存失败:数据库连接不可用。请检查网络/数据库服务后重试"
2026-11-10 23:42:50 +08:00
}
2026-11-17 06:41:41 +08:00
// ③ 未归类的底层数据库错误(pq:/SQLSTATE/ent 约束):兜底友好提示,附原始错误供定位,避免吞掉线索
isDB := strings . Contains ( lower , "pq:" ) ||
strings . Contains ( lower , "sqlstate" ) ||
strings . Contains ( lower , "ent: constraint failed" ) ||
strings . Contains ( lower , "constraint failed" ) ||
strings . Contains ( lower , "constraint violation" )
if isDB {
return "保存失败:数据校验未通过或数据库处理异常,请核对录入内容后重试;若反复出现请把提示原文反馈维护人员(" + raw + ") "
}
// ④ 纯业务文本:原样返回,不误伤
return raw
2026-11-10 23:42:50 +08:00
}
2026-08-28 15:06:01 +08:00
// Fail 业务失败(HTTP 200,业务码非0)
func Fail ( w http . ResponseWriter , code int , message string ) {
2026-11-10 23:42:50 +08:00
writeJSON ( w , http . StatusOK , Resp { Code : code , Message : friendlyMessage ( message )})
2026-08-28 15:06:01 +08:00
}
// FailHTTP 直接返回 HTTP 错误
func FailHTTP ( w http . ResponseWriter , status int , message string ) {
2026-11-10 23:42:50 +08:00
writeJSON ( w , status , Resp { Code : status , Message : friendlyMessage ( message )})
2026-08-28 15:06:01 +08:00
}
2026-10-20 16:36:26 +08:00
// FailValidation 收集式校验失败(HTTP 200, code=3015, data.errors 结构化清单;
// 前端拦截器识别 3015 后用 ErrorListDialog 一次弹全,不用 ElMessage 单条)。
func FailValidation ( w http . ResponseWriter , errs [] verr . FieldError ) {
writeJSON ( w , http . StatusOK , Resp {
Code : 3015 ,
Message : fmt . Sprintf ( "保存失败,共 %d 项需要处理" , len ( errs )),
Data : map [ string ] any { "errors" : errs },
})
}
// FailErr 统一错误出口:*verr.ValidationError → FailValidation 结构化;其他 error → 普通 Fail(3010)。
func FailErr ( w http . ResponseWriter , err error ) {
var ve * verr . ValidationError
if errors . As ( err , & ve ) {
FailValidation ( w , ve . Errors )
return
}
Fail ( w , 3010 , err . Error ())
}
2026-08-28 15:06:01 +08:00
// BadRequest 参数错误
func BadRequest ( w http . ResponseWriter , message string ) {
2026-11-10 23:42:50 +08:00
writeJSON ( w , http . StatusBadRequest , Resp { Code : 400 , Message : friendlyMessage ( message )})
2026-08-28 15:06:01 +08:00
}
func InternalError ( w http . ResponseWriter , message string ) {
2026-11-10 23:42:50 +08:00
writeJSON ( w , http . StatusInternalServerError , Resp { Code : 500 , Message : friendlyMessage ( message )})
2026-08-28 15:06:01 +08:00
}
func Unauthorized ( w http . ResponseWriter , message string ) {
writeJSON ( w , http . StatusUnauthorized , Resp { Code : 401 , Message : message })
}
// ParseJSON 解析请求体
func ParseJSON ( r * http . Request , v any ) error {
dec := json . NewDecoder ( r . Body )
return dec . Decode ( v )
}