Template
SkyJourney
61017f1c39
Core 基础设施：Flavor 三包体系、Drift+SQLCipher 加密数据库 7 拦截器 Dio 网络栈、CrashReporter 崩溃日志、Sealed Failure 错误体系 5 色板主题系统、Auth 认证骨架（Clean Architecture）、Dev Panel、Mock Adapter 通过验证：flutter analyze（0 errors）、flutter test（全绿）、staging APK 74.8MB
51 lines
1.9 KiB
Dart
51 lines
1.9 KiB
Dart
/// 服务端业务错误码常量。
|
||
///
|
||
/// envelope 结构：`{retCode: String, retMsg: String, retData: T?}`（key map: code/msg/data）
|
||
/// 错误码格式：`A04XX` = 客户端错 / `A05XX` = 服务端错 / `99999` = 兜底 / `00000` = 成功
|
||
abstract class ResponseCode {
|
||
/// 成功
|
||
static const String success = '00000';
|
||
|
||
/// 兜底请求失败
|
||
static const String generic = '99999';
|
||
|
||
/// 服务端 500 类
|
||
static const String serverError = 'A0500';
|
||
static const String systemError = 'A0501';
|
||
|
||
/// 客户端 400 类
|
||
static const String paramError = 'A0400';
|
||
static const String paramMissing = 'A0402';
|
||
static const String resourceNotFound = 'A0404';
|
||
|
||
/// 鉴权过期 → 跳登录
|
||
static const String unauthorized = 'A0401';
|
||
|
||
/// Token 类业务码（占位 — 待后端确认实际值后改这里一处）。
|
||
// TODO: 后端确认后更新 tokenExpired / tokenInvalid 实际字符串值
|
||
static const String tokenExpired = 'TOKEN_EXPIRED';
|
||
static const String tokenInvalid = 'TOKEN_INVALID';
|
||
|
||
/// 仅 token 类业务码才允许 TokenRefreshInterceptor 触发 refresh。
|
||
static bool isTokenRefreshable(String? code) =>
|
||
code == unauthorized || code == tokenExpired || code == tokenInvalid;
|
||
|
||
static bool isSuccess(String? code) => code == success;
|
||
|
||
static bool isUnauthorized(String? code) => code == unauthorized;
|
||
|
||
/// 用户友好的错误提示。
|
||
static String friendlyMessage(String? code, String fallback) {
|
||
return switch (code) {
|
||
success => '',
|
||
unauthorized => '登录已过期，请重新登录',
|
||
paramError => '请求参数有误，请稍候重试',
|
||
paramMissing => '请求参数不完整，请稍候重试',
|
||
resourceNotFound => '请求的资源不存在',
|
||
serverError || systemError => '服务器开小差啦，请稍候重试',
|
||
generic => '请求失败',
|
||
_ => fallback,
|
||
};
|
||
}
|
||
}
|