refactor: 后端代码质量优化 - 复用公共库、使用标准库、类型安全错误判断
## 高优先级修复 - stats_service_impl: 使用 strings.SplitN 替代错误的索引分割 - provider_handler: 使用 errors.Is(err, gorm.ErrDuplicatedKey) 替代字符串匹配 - client: 重写 isNetworkError 使用 errors.As/Is 类型安全判断 - proxy_handler: 使用 encoding/json 标准库解析 JSON(extractModelName、isStreamRequest) ## 中优先级修复 - stats_handler: 添加 parseDateParam 辅助函数消除重复日期解析 - pkg/errors: 新增 ErrRequestCreate/Send/ResponseRead 错误类型和 WithCause 方法 - client: 使用结构化错误替代 fmt.Errorf - ConversionEngine: logger 依赖注入,替换所有 zap.L() 调用 ## 低优先级修复 - encoder: 删除 joinStrings,使用 strings.Join - adapter: 删除 modelInfoRegex 正则,使用 isModelInfoPath 字符串函数 ## 文档更新 - README.md: 添加公共库使用指南和编码规范章节 - specs: 同步 delta specs 到 main specs(error-handling、structured-logging、request-validation) ## 归档 - openspec/changes/archive/2026-04-20-refactor-backend-code-quality/
This commit is contained in:
@@ -47,6 +47,24 @@
|
||||
- **THEN** SHALL 使用 ErrInternal 等预定义错误
|
||||
- **THEN** SHALL 设置 HTTP 状态码为 500
|
||||
|
||||
#### Scenario: 请求创建错误
|
||||
|
||||
- **WHEN** 创建 HTTP 请求失败
|
||||
- **THEN** SHALL 使用 ErrRequestCreate 预定义错误
|
||||
- **THEN** SHALL 设置 HTTP 状态码为 500
|
||||
|
||||
#### Scenario: 请求发送错误
|
||||
|
||||
- **WHEN** 发送 HTTP 请求失败
|
||||
- **THEN** SHALL 使用 ErrRequestSend 预定义错误
|
||||
- **THEN** SHALL 设置 HTTP 状态码为 500
|
||||
|
||||
#### Scenario: 响应读取错误
|
||||
|
||||
- **WHEN** 读取 HTTP 响应失败
|
||||
- **THEN** SHALL 使用 ErrResponseRead 预定义错误
|
||||
- **THEN** SHALL 设置 HTTP 状态码为 500
|
||||
|
||||
### Requirement: 支持错误包装
|
||||
|
||||
系统 SHALL 支持错误包装。
|
||||
@@ -127,6 +145,30 @@
|
||||
- **THEN** SHALL 包装数据库错误
|
||||
- **THEN** SHALL 转换为应用错误
|
||||
|
||||
### Requirement: 使用类型安全错误判断
|
||||
|
||||
系统 SHALL 使用类型安全方式判断错误类型。
|
||||
|
||||
#### Scenario: 数据库错误判断
|
||||
|
||||
- **WHEN** 判断数据库唯一约束错误
|
||||
- **THEN** SHALL 使用 errors.Is(err, gorm.ErrDuplicatedKey)
|
||||
- **THEN** SHALL NOT 使用字符串匹配 err.Error()
|
||||
|
||||
#### Scenario: 网络错误判断
|
||||
|
||||
- **WHEN** 判断网络错误
|
||||
- **THEN** SHALL 使用 errors.As(err, &net.Error) 判断网络错误
|
||||
- **THEN** SHALL 使用 errors.As(err, &net.OpError) 判断操作错误
|
||||
- **THEN** SHALL 使用 errors.Is(opErr.Err, syscall.ECONNRESET) 判断连接重置
|
||||
- **THEN** SHALL NOT 使用字符串匹配判断错误类型
|
||||
|
||||
#### Scenario: 错误链判断
|
||||
|
||||
- **WHEN** 判断错误链中的特定错误
|
||||
- **THEN** SHALL 使用 errors.Is 进行链式判断
|
||||
- **THEN** SHALL 使用 errors.As 提取特定类型错误
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 定义 ConversionError 错误类型
|
||||
|
||||
Reference in New Issue
Block a user