Documentation
状态速查、常见问题与故障排查
状态速查、常见问题与故障排查
适用版本:会员插件 1.3.3 · 核对日期:2026-10-10
用途
按用户操作、业务记录、流水、账户和异步处理链路定位问题,避免用盲目重试造成重复变更。
前置条件
保留用户名、操作时间、业务 ID、交易 ID 或 MCP 请求 ID。查询时使用有权限账号,不公开凭据、卡密或个人收款信息。
操作入口
会员信息、等级记录、推荐记录、交易记录、签到记录、积分事件,以及 Halo/核心插件日志和调度结果。
操作步骤
- 先判断失败发生在页面、接口、业务受理、账户入账还是外部交付阶段。
- 查插件启用、产品授权、角色权限与能力开关。
- 用原业务 ID 查关联记录,核对状态和日期范围。
- 关联账户变化时核对流水与账户处理标记;等级问题另查角色。
- 支付、任务和通知分别查对应外部系统结果。
- 只有确认原结果和原因后再执行补偿或重试;重试沿用原稳定请求 ID。
预期结果与核对
形成可说明的证据链:谁在何时做了什么、对应记录是什么、当前账户和外部结果是否一致。
限制与注意事项
记录存在、HTTP 200、已受理、流水成功和实际交付各自表达不同阶段。删除历史或直接修改成功状态不能代替结果核对。页面自动化、单元测试和构建通过也不证明真实支付、通知或等级角色流程完成。
常见问题
- 没有会员入口? 查插件启用、UI 加载和角色权限。
- 已付款未到账? 查支付订单 → 同步任务 → 会员充值流水 → 账户处理。
- 等级发放没生效? 查等级记录 → 当前等级 → 有效期 → 角色。
- MCP 超时? 先查原请求调整结果,不改 ID 重放。
- 积分互动没奖励? 查活动是否合格 → 发布规则和时间 → 来源历史 → 限额/延迟 → 事件与流水。
不同状态体系
| 对象 | 状态或结果 | 核对重点 |
|---|---|---|
| 会员 | 0 正常、1 冻结 | 属于会员业务状态,不是 Halo 登录开关 |
| 等级配置 | 0 停用、1 启用 | 不等同于所有会员权益是否已撤销 |
| 等级记录 | PENDING、NORMAL、EXPIRED | 当前生效、时间与角色需另查 |
| 交易流水 | PENDING、PROCESSING、SUCCESS、FAILED、CANCELLED | 账户是否已处理 |
| 积分事件 | RECEIVED 到 GRANTED/REVOKED 等 | 规则快照、原因与关联流水 |
| MCP 账户调整 | PENDING、PROCESSED 等 | 原请求 ID、审计流水及账户标记 |
| MCP 等级发放 | ACCEPTED | 后续会员等级与角色生效 |