Documentation
常见问题、状态速查与故障排查
常见问题、状态速查与故障排查
适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。
状态速查
| 对象 | 状态 |
|---|---|
| 产品 | UNPUBLISHED 未发布；PUBLISHED 已发布 |
| 版本 | UNPUBLISHED 未发布；ONLINE 在线；OFFLINE 下线 |
| 授权订单 | PENDING 待支付；SUCCEED 成功；FAILED 失败 |
| 商城订单 | PENDING 待支付；PAID 已支付；WAIT_SHIPMENT 待发货；FULFILLED 已履约；FAILED 失败；CLOSED 已关闭 |
| 授权 | UNAUTHORIZED 未授权；AUTHORIZED 已授权；EXPIRED 已过期 |
| 卡密 | AVAILABLE 可发放；DELIVERED 已发放；DISABLED 已停用 |
| 优惠券 | UNUSED 未使用；USED 已使用；EXPIRED 过期或停用 |
| 套餐权益 | WAITING_PAYMENT 等待支付；PROVISIONING 准备中；READY 就绪；PARTIAL_FAILED 部分失败 |
| 订单动作 | PENDING、RUNNING、RETRYING、SUCCEEDED、FAILED |
产品没有出现在商城
检查产品是否已发布、分类是否启用、筛选条件及接口结果。只在 Core 缺失时，另查应用类型、在线安装包和客户端能力。未声明套餐能力的旧客户端不会显示套餐。
支付成功后没有授权或卡密
先确认原订单实际支付结果。授权产品检查购买账号、期限及域名授权是否创建；卡密商品检查自动发放、可发放库存和失败订单项。套餐检查父订单与成员权益计划，不能直接给父 Key 发放单品授权。
商品订单不能修改或删除
商品和数量仅待支付时可改，金额由商品明细重算；支付后保留交易与履约事实。不能追加或单删明细，待支付可删整笔订单，其他符合条件的状态使用关闭操作。已履约不能靠关闭回到未交付。
套餐发布或恢复失败
检查至少两个不重复单品成员、父产品无安装目标、正常正价、成员发布状态与在线版本。恢复时区分临时保存错误与父子订单一致性冲突；不可重试冲突需人工核对，成功成员保留。
优惠没有生效
检查全局与产品开关、券归属和范围、时间及次数、推荐码是否有效且不是本人、会员身份和最终结算结果。折扣参数 80 表示支付原价的 80%，即八折；满减参数使用类似 100-20 的门槛与抵扣值。
CI 或 MCP 失败
CI 检查独立推送令牌、产品绑定、文件摘要、存储策略和下载可达性，新版本还需要上线。MCP 检查连接地址、当前进程凭据、密钥白名单和产品插件许可证。写入未知失败先读回，卡密导入按原批次核对。
提交排障信息
提供产品 Key、订单或记录 ID、操作时间、入口、错误码及安全摘要，并说明实际渠道是否扣款、是否已经交付。敏感令牌、证书、卡密和完整收件信息按业务需要保护，不直接粘贴到公共反馈中。
评论