1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! 异常模块,提供细化异常类型与统一错误枚举。
use HashMap;
pub use crateGarrisonError;
/// 未登录异常,表示请求缺少有效登录态。
/// 携带上下文的业务可恢复异常。
///
/// 与 `GarrisonError` enum 解耦,提供 token / login_id / extras 上下文;经 `new(code, msg).with_*(..).build()` 链式构造,`Into<GarrisonError>` 转为 `GarrisonError::Exception` 上抛。
///
/// # ⚠️ 安全说明
///
/// 手动 `Debug` 实现:`token_value` 脱敏为前 8 字符 + `***`,防 `{:?}` 泄露到日志;字段保持 `pub`(pre-1.0 兼容),但后改字段仍走脱敏(`mask_preview`),`extras` 在日志与 HTTP 响应体均经 `sanitize_extras` 过滤;需不可变保证场景用链式构造且不暴露 `&mut`。