部署不生效:改了配置但客户还是看到旧版本
问题现象
- 你在 Sandbox 里改了欢迎语 → Publish → Deployments 显示 Live 已更新
- 你用 Staging 的测试号码打进去,听到的是新欢迎语 ✓
- 客户用生产号码打进去,听到的还是旧欢迎语 ✗
排查路径
第一步:确认 Publish 真的成功了
打开 Deployments → Live history,看:
- 最新版本的时间戳是不是你的 Publish 时间?
- 点击最新版本看 diff,里面有没有你改的内容?
如果 diff 里没有你改的内容,说明 Publish 过程中有问题(可能是合并冲突没解决、或 Branch 没正确 Push 回去)。回到 Studio 或 ADK 重新操作一遍。
第二步:检查号码绑定到哪个环境
最常见的"部署不生效"原因——你改了 A 环境,但生产号码绑定在 B 环境。
打开 Voice → Numbers,逐个看每个号码绑定的环境(Sandbox / Staging / Live):
| 号码 | 绑定环境 | 你的 Publish 环境 | 结果 |
|---|---|---|---|
| +1 (800) XXX-XXXX(生产号码) | Live | Live | ✓ 生效 |
| +1 (800) XXX-XXXX(生产号码) | Staging | Live | ✗ 不生效!生产号码还在 Staging |
这种情况的原因通常是:新开通项目时默认 Staging,后来忘了切到 Live;或者之前做测试时临时改了号码绑定,测试完忘了切回去。
修复:把生产号码从 Staging 切到 Live。这个改动实时生效,不需要重新 Publish。
第三步:检查是不是多环境 / 多项目混淆
复杂场景下(多个项目、多个 Apex 号码)容易搞混:
| 混淆场景 | 检查 |
|---|---|
| 多个项目,改了项目 A 但客户打的号码属于项目 B | 确认号码 → 项目 → 环境的完整映射 |
| 同一个 PolyAI 集群里多个客户账户 | 检查登录的账户对不对 |
| 号码从 PolyAI 购买的 vs 外部 Port-in 的 | 外部号码的路由可能还在旧平台上,需要确认转发目标 |
第四步:真实号码延迟(极少见)
极罕见的情况:生产号码的路由更新有延迟(Twilio / Vonage / 运营商那边需要同步),可能需要几分钟到几十分钟。等 15-30 分钟后再测试,如果还是不生效联系 PolyAI 技术支持。
部署生效的快速验证方法
每次 Publish 后,按这个顺序快速验证:
- 看 Deployments → Live history 最新版本时间戳 ✓ → 进入步骤 2
- Voice → Numbers 确认生产号码绑定 Live ✓ → 进入步骤 3
- 用生产号码打一个测试电话,听欢迎语或问一个刚改过的 FAQ → 确认生效
三步走完,99% 的部署问题都能定位。