腾讯云 “消息队列 CMQ” 产品正在下线过程中，2026 年 8 月 31 日将正式下线并停止服务。本文主要对旧版 CMQ 迁移事项做出说明并指导客户进行自查，确认是否全部资源迁移完成。
旧版 CMQ 下线背景周知
自2023年起，腾讯云消息队列团队对消息队列 CMQ（以下简称旧版 CMQ）进行了大量稳定性和技术优化，同时结合消息队列产品系列 TDMQ（Tencent Distributed Message Queue） 整体品牌升级策略，使用最新的商业化产品消息队列 TDMQ CMQ 版（以下简称新版 CMQ）承接。
新版 CMQ 完全兼容旧版 CMQ 的 SDK 和功能，并按照 TDMQ CMQ 版的商业化规则进行计费，计费规则见 新版 CMQ 计费概述。腾讯云会按照服务等级协议为 TDMQ CMQ 版提供质量保障，服务等级协议见 新版 CMQ 服务等级说明。
旧版 CMQ 迁移说明
自2023年下半年起，消息队列团队陆续通过站内信、短信和邮箱等方式推送过 “消息队列 CMQ（旧版 CMQ）的下线通知”。为了减少产品迁移对存量客户的影响，腾讯云消息队列团队提供了无感迁移方案，理论上对客户无感，客户仅需要在迁移期间保持关注，观察监控告警即可。
迁移后，建议您将业务代码中的旧版 CMQ 的 API 请求地址（Endpoint 接入地址）修改为 TDMQ CMQ 的 API 请求地址（Endpoint 接入地址），后者的请求地址网络链路更短，请求延迟更低，详情见旧版 CMQ 接入地址切换指南。
当前，大部分活跃资源已经迁移完成，少量不活跃资源仍然在旧版 CMQ 控制台上保留。请您根据以下指引，对比旧版 CMQ 和 TDMQ CMQ 的控制台数据，确认没有遗留的资源需要迁移。
存量数据排查
您可以按照以下步骤来排查旧版 CMQ 资源是否迁移完成：
1. 分别登录同一地域的 TDMQ CMQ 与旧版 CMQ 控制台；
2. 对比两个控制台中队列/主题列表底部的元数据条数记录（如下图所示），初步核查是否存在未迁移的数据；
3. 若发现条数存在差异，使用旧版 CMQ 控制台的搜索功能，输入疑似未迁移的队列或主题名称，定位具体未迁移的资源；
4. 打开业务代码，通过搜索队列/主题名称的方式，进一步验证未迁移的资源是否仍在业务系统中被使用。
5. 如果确认某些旧版 CMQ 控制台的队列或主题需要迁移到 TDMQ CMQ，您可以通过提交工单联系腾讯云消息队列团队进行迁移。
TDMQ CMQ 控制台入口：
旧版 CMQ 控制台入口：
修改客户端接入点
旧版 CMQ 控制台的队列或者主题迁移后，请将业务代码中的旧版 CMQ 的 API 请求地址（Endpoint 接入地址）修改为 TDMQ CMQ 的 API 请求地址（Endpoint 接入地址），详细操作见旧版 CMQ 接入地址切换指南。
