ErrorCatalog 单一权威来源与双通道错误处理
背景
错误码/文案/HTTP 状态分散在控制器内导致漂移;应用侧与协议侧错误体格式天然不同。
决策
全部错误码(含 OAuth2 协议码)的 code/numeric/category/HTTP 状态/默认文案以编译期 ErrorCatalog 为唯一权威;Application 端点走 ErrorResponder 错误信封,协议端点走 RFC 6749 错误体(含 Filter 层);前端错误目录镜像后端并构建期校验(errorAdapter 纯函数)。原则:不同失败原因不得折叠进同一 code;例外:防枚举场景(账户锁定与密码错误同码)是刻意设计。
后果与现状对照
ErrorCatalog.cc(525 行)+ 单测强制文档同步(api-reference 错误表由测试校验);PR#85 的 4006 即按此流程新增。