1.1 KiB
1.1 KiB
Why
当前业务错误都是字符串消息（throw new BadRequestException('用户名已存在')），无统一错误码，前端无法按 code 分支处理，fork 后各模块各自为政。需要一套「业务域 + 错误序」的错误码注册表作为单一事实源。
What Changes
- 新增
src/common/error-codes.ts错误码注册表（5 位数字[域码 2 位][序 3 位]，域码集中登记）。 - 新增
BusinessException(code, message, status)；AllExceptionsFilter识别业务码，非业务异常仍回退HTTP×100。 - 迁移关键业务错误（登录/锁定/待改密/用户名冲突/租户不存在等）到注册码。
Capabilities
Modified Capabilities
shared/api-contract: 「错误码分段」改为「业务域 + 错误序」细分段。
Impact
- 后端：
error-codes.ts+business-exception.ts（common）、AllExceptionsFilter识别业务码、auth/users/tenants 等关键 throw 迁移。 - 文档：guide.md 补错误码注册表说明。
- 无数据/前端变更（前端仍读
code+message）。