🏷️ 美团券核销Session异常处理

核心要点

美团券核销Session异常时重新授权恢复的处理流程。

⚠️ 2026-09-07 重要更新：美团核销失败不止 Session 异常一种。历史上有过"授权静默失败"（页面提示成功但实际未生效）＋ Redis 认证配置未同步的双故障叠加案例，拖了 7 天。完整复盘见 美团核销失败故障复盘-20260901。 🔴 平台已变更（重要）：本卡片正文记录的 e.dianping.com/dz-open/merchant/auth（2024）属老平台流程。2025-04 起切换新平台：授权地址 open-erp.meituan.com/authorize/auth、回调路径 /meituan2/authcode、参数改为 developerId/businessId/sign/state/timestamp。 👉 现行授权请一律使用 美团券授权操作清单，不要用本卡片下方的老链接。

关联概念

1. 报错含义：美团Session获取异常 → 授权过期或失效
2. 恢复流程：登录美团开店宝平台 → 访问授权地址 → 按提示授权
3. 关键参数：app_key（应用密钥）、state、redirect_url（回调地址，如 jngh.net:9003/meituan/authcode）
4. 授权成功：授权页面提示成功后，核销功能恢复
5. 🔴 硬约束：必须在【非内网（外网）】环境完成授权（2026-09-07 血泪补充）

• 内网环境下授权会静默失败：页面照样提示成功，但实际从未生效

6. 🔴 **state 必须填写门店编码（示例ERP系统系统机构编码），不得留空、不得照抄文档示例值 teststate**（照抄 = 授权绑定不到门店）
7. 🔴 验证方式：必须以"实际核销成功"为准，不能只看授权页面提示
8. 🔑 最快判定手法：查授权调用日志。日志里一条授权调用记录都没有 → 授权从未成功。（来源 美团核销失败故障复盘-20260901，本次破局点）
9. ⏰ 授权链接有效期仅 24 小时——生成后须当日完成授权，隔天使用即失效（同样静默失败）
10. 🔗 回调地址须为 HTTPS 域名（不支持 HTTP、不建议 IP），且 CRMAPICORE 端口已做外网映射——这是"非内网授权"的真正含义

应用场景

• 美团核销失败故障复盘-20260901：🔴 强关联——本次故障的完整案例（Redis配置未同步 + 授权静默失败双故障叠加）
• 抖音券核销失败排查：同类对比——同为第三方券核销故障
• 抖音收款报错与WS服务更新：同类对比——同为线上支付/服务授权问题
• 馈赠活动赠券中断排查：同类对比——同为券类功能异常
• 储值卡报表查询白名单报错：同类对比
• 功能报错自愈与应用程序池回收：同类对比
• 线上销售全额退金额传递不一致：同类对比
• 移动权益数据合并支付：同类对比——同为支付/权益类异常
• 静默失败排查-日志缺失证据法：延伸应用——从本故障复盘提炼的通用排查方法

常见误区

• 场景1：美团券核销报Session获取异常
• 场景2：美团平台授权过期需重新授权
• 场景3：第三方支付渠道授权管理

参考来源

• 误区1：Session异常是系统bug → 正确做法：多为授权过期，重新授权即可
• 误区2：改代码解决 → 正确做法：先走授权流程恢复
• 误区3 🔴：授权页面提示成功 = 授权成功 → 正确做法：内网环境下会静默失败，必须实际发起一笔核销验证
• 误区4 🔴：核销失败一定是授权问题 → 正确做法：也可能是核销服务 Redis 连接配置未同步（升级加密码后常见）；两者可能同时存在

变更日志

• Shine-Hamster > 02-Areas/06-故障沉淀/美团券核销报错【美团Session获取异常】处理.md

操作速查

• 2026-08-05：初始创建（消化 Shine-Hamster 故障沉淀）
• 2026-09-07：🔴 重大回补（据 美团核销失败故障复盘-20260901）——补入"必须在非内网授权""state 必填""页面提示成功≠授权成功"三条关键约束，新增 Redis 配置未同步症状分支与"双故障叠加"排查提示
• 2026-09-07：🔴 平台变更标注（据官方配置文档 济宁贵和美团券新平台配置20250428.docx）——本卡片正文为老平台（2024）流程，新平台已切换至 open-erp.meituan.com/authorize/auth + /meituan2/authcode；补入 state=门店编码、链接 24 小时有效期、回调须 HTTPS 域名+CRMAPICORE 外网映射。现行操作一律走 美团券授权操作清单

排查指引

🔴 新平台（2025-04 起）请直接用 美团券授权操作清单。以下为老平台（2024）流程，仅供排查参考，勿照抄执行。

1. ⚠️ 前置条件：确保在【非内网 / 外网】环境操作（内网授权会静默失败）
2. 登录美团开店宝：https://ecom.meituan.com/bizaccount/login.html
3. 访问授权地址（**state 必须填写**，teststate 仅为示例值）：

   https://e.dianping.com/dz-open/merchant/auth?app_key=<应用密钥>&state=<必填>&redirect_url=http://jngh.net:9003/meituan/authcode

4. 按提示完成授权
5. ⚠️ 验证：必须实际发起一笔核销确认成功，不能只看授权页面提示

正文

• 症状A：美团券核销报"Session获取异常"
• 检查：授权是否过期 / 是否在内网完成的授权 / state 是否填写
• 处理：外网环境重走授权流程 → 实际核销验证

• 症状B：核销报 Redis 异常（AuthenticationFailure / timeout 3000ms）
• 检查：核销服务 enjoypayproxycore 的 Redis 连接配置 —— 升级后 Redis 是否新增了密码而未同步
• 处理：补齐密码配置 → 重启服务 → 验证

• 🔴 症状C：改完配置仍核销失败
• 立即怀疑存在第二个独立故障（如授权从未成功），不要在同一方向继续深挖
• 口诀：*"改对了却没好，八成不止一个错。"*
• 参考完整案例：美团核销失败故障复盘-20260901