# 子域名适配测试方案

## 背景

开发者社区新增了独立子域名访问方式，用户现在可以通过两种路径访问社区：

- **旧路径**：`https://cloud.tencent.com/developer`（及 `.cn` / `.com.cn` 后缀）
- **新子域名**：`https://developer.cloud.tencent.com`（及 `.cn` / `.com.cn` 后缀）

改造涉及三个项目：**开发者社区主站**（qcloud-developer）、**竞赛子站**（qcloud-competition）、**新版社区**（qcloud-community）。

**测试策略**：以"机制/场景"为主轴，每类机制选代表页面验证，而非逐页测试。相同机制覆盖的页面，验证一个即可代表同类。

**按照机制测试的好处**

1. 测试量大幅压缩，但覆盖率不降
  三个项目加起来 100+ 页面，但域名跟随的实现机制只有几种。同一种机制验证一个代表页面，就能覆盖所有走这条路的页面。逐页测不会发现更多问题，只会浪费时间。
 2. 发现问题后归因快
  按页面测，发现 A 页面有问题、B 页面没问题，很难快速判断原因。按机制测，一旦某个机制出问题，能立刻知道影响范围——比如登录跳转的硬编码有问题，就知道所有页面的登录都受影响，不用一个个页面排查。
 3. 重点突出，优先级清晰
  不同机制的风险程度不一样。比如 GlobalListener 是全局兜底，一旦生效所有 a 标签都安全；而登录跳转是硬编码，是真正的高风险点。按机制拆分后，P0/P1/P2 的划分有依据，测试资源可以集中在真正危险的地方。
 4. 复现和回归效率高
  如果某个机制出了 bug 修复后，回归只需要验证该机制对应的几个用例，而不是重新跑所有页面。
  简单说就是： 测的是"为什么会出问题"，而不是"哪个页面出了问题"。前者更接近问题的根本，后者只是表象。

### 域名对照表

| 后缀 | 旧路径入口 | 新子域名入口 |
|------|-----------|------------|
| .com | `cloud.tencent.com/developer` | `developer.cloud.tencent.com` |
| .cn | `cloud.tencent.cn/developer` | `developer.cloud.tencent.cn` |
| .com.cn | `cloud.tencent.com.cn/developer` | `developer.cloud.tencent.com.cn` |

> 以下测试如无特别说明，均以 `.com` 后缀为例进行功能验证，`.cn` 和 `.com.cn` 后缀在「跨后缀一致性」章节单独回归。

---

## 一、六个入口冒烟

> 最基础的验证：六个入口都能打开，不报错。

| # | 访问地址 | 预期结果 |
|---|---------|---------|
| 1 | `https://cloud.tencent.com/developer` | 正常打开开发者社区首页 |
| 2 | `https://cloud.tencent.cn/developer` | 正常打开开发者社区首页 |
| 3 | `https://cloud.tencent.com.cn/developer` | 正常打开开发者社区首页 |
| 4 | `https://developer.cloud.tencent.com` | 正常打开开发者社区首页 |
| 5 | `https://developer.cloud.tencent.cn` | 正常打开开发者社区首页 |
| 6 | `https://developer.cloud.tencent.com.cn` | 正常打开开发者社区首页 |

---

## 二、机制一：服务端渲染链接（SSR 生成的 href）

> **机制说明**：页面 HTML 在服务端生成时，链接 href 就已经写入了正确的域名。验证服务端是否根据请求域名输出了匹配的链接。
>
> **验证方法**：打开页面后，右键「查看网页源代码」，搜索 `href=`，检查链接中的域名。

| 项目 | 代表页面 | 新子域名地址 | 旧路径地址 | 检查内容 |
|------|---------|------------|---------|---------|
| qcloud-developer | 沙龙详情页 | `developer.cloud.tencent.com/salon/salon-{沙龙ID}` | `cloud.tencent.com/developer/salon/salon-{沙龙ID}` | 源码中沙龙相关链接（报名按钮、分享链接、推荐沙龙等）是否已为对应域名 |
| qcloud-community | 文章详情页 | `developer.cloud.tencent.com/article/{文章ID}` | `cloud.tencent.com/developer/article/{文章ID}` | 源码中 `<a href>` 是否已为对应域名 |
| qcloud-competition | 竞赛介绍页 | `competition.cloud.tencent.com/introduction/{竞赛ID}` | `cloud.tencent.com/competition/introduction/{竞赛ID}` | 源码中页面内链接是否已为对应域名 |

### 判断标准

- 新子域名访问：源码中链接应含 `developer.cloud.tencent.com`
- 旧路径访问：源码中链接应含 `cloud.tencent.com/developer`
- **不应出现**：通过新子域名访问，但源码中仍有 `cloud.tencent.com/developer` 的链接

---

## 三、机制二：客户端动态链接跟随（GlobalListener / handleMouseOver）

> **机制说明**：GlobalListener 挂载在 `document` 上，是全局兜底策略。用户鼠标悬停任意 `<a>` 标签时，JS 实时把 href 改写为当前访问域名。**页面内所有 `<a>` 标签链接均受此机制保护**，包括导航菜单、正文内链、推荐卡片、后台配置的硬编码链接等。
>
> **验证方法**：打开页面，将鼠标悬停到链接上，观察浏览器左下角状态栏显示的 URL，或右键链接查看 href。

### 3.1 导航栏链接

| 项目 | 代表页面 | 验证操作 | 预期结果 |
|------|---------|---------|---------|
| qcloud-developer | `developer.cloud.tencent.com` | 通过新子域名访问，悬停顶部导航各菜单项（学习、活动、专区等） | href 显示 `developer.cloud.tencent.com`，不出现 `cloud.tencent.com/developer` |
| qcloud-community | `developer.cloud.tencent.com` | 同上 | 同上 |
| qcloud-competition | `competition.cloud.tencent.com` | 悬停竞赛首页导航链接 | href 显示竞赛子域名 |

### 3.2 底部菜单链接

> 底部菜单（技术文章、技术问答、学习中心等）由后台配置，链接硬编码了 `cloud.tencent.com/developer/xxx`，GlobalListener 在悬停时统一改写。

| 代表页面 | 验证操作 | 预期结果 |
|---------|---------|---------|
| `developer.cloud.tencent.com` | 通过新子域名访问，悬停页面底部菜单中各链接 | href 显示 `developer.cloud.tencent.com`，不出现旧路径 |
| `developer.cloud.tencent.cn` | 通过 `.cn` 后缀访问，悬停底部菜单链接 | href 显示 `.cn` 后缀域名 |

### 3.3 官网链接后缀跟随

> 页面中硬编码了官网链接（如 `cloud.tencent.com/product/cvm`、`cloud.tencent.com/act/xxx` 等指向官网产品页、活动页的链接），GlobalListener 同样会改写这类链接的域名后缀。

| 代表页面 | 验证操作 | 预期结果 |
|---------|---------|---------|
| `developer.cloud.tencent.cn`（底部菜单或导航中含官网产品链接） | 通过 `.cn` 后缀访问，悬停底部菜单「热门产品」中的云服务器、域名注册等链接 | href 应为 `cloud.tencent.cn/product/xxx`，不出现 `cloud.tencent.com` |
| `developer.cloud.tencent.com.cn` | 通过 `.com.cn` 后缀访问，悬停同类官网链接 | href 应为 `cloud.tencent.com.cn/product/xxx` |

### 3.4 文章正文内链

> 找一篇正文中有其他社区文章链接的文章（可搜索包含 `cloud.tencent.com/developer` 的文章）

| 项目 | 代表页面 | 验证操作 | 预期结果 |
|------|---------|---------|---------|
| qcloud-developer | `developer.cloud.tencent.com/article/{文章ID}` | 通过新子域名访问，悬停正文中的内链 | href 改写为新子域名 |
| qcloud-community | `developer.cloud.tencent.com/article/{文章ID}` | 同上 | href 改写为新子域名 |

### 3.4 内容列表卡片链接

| 代表页面 | 验证操作 | 预期结果 |
|---------|---------|---------|
| `developer.cloud.tencent.com`（社区首页） | 悬停首页文章卡片、问答卡片 | href 为新子域名 |
| `developer.cloud.tencent.com/ask`（问答列表） | 悬停每条问题链接 | href 为新子域名 |

### 3.5 旧路径下的反向验证

| 验证操作 | 预期结果 |
|---------|---------|
| 通过旧路径 `cloud.tencent.com/developer` 访问首页，悬停任意链接 | href 应为旧路径格式，不应出现新子域名 |

---

## 四、机制三：JS 直接跳转（GlobalListener 无法覆盖的场景）

> **机制说明**：GlobalListener 只能拦截 `<a>` 标签的 `mouseover` 事件。以下场景通过 `location.href`、`location.replace()`、`window.open()` 等方式直接跳转，**不经过 GlobalListener**，需要代码中单独处理域名。
>
> 这是域名适配最容易出 bug 的地方。

### 4.1 登录跳转（高风险）

> 代码中登录跳转地址为 `https://cloud.tencent.com/login?s_url=${backUrl}`，域名硬编码，是本次改造的高风险点。

| # | 场景 | 页面地址 | 验证操作 | 预期结果 |
|---|------|---------|---------|---------|
| 1 | 新子域名下触发登录 | `developer.cloud.tencent.com` 任意页面（如首页、文章详情页），未登录状态 | 点击「登录」按钮，完成登录 | 登录成功后跳回原页面，URL 仍为 `developer.cloud.tencent.com`，不跳到 `cloud.tencent.com` |
| 2 | `.cn` 后缀下触发登录 | `developer.cloud.tencent.cn` 任意页面，未登录状态 | 点击「登录」按钮，完成登录 | 登录成功后跳回 `.cn` 后缀页面 |
| 3 | `.com.cn` 后缀下触发登录 | `developer.cloud.tencent.com.cn` 任意页面，未登录状态 | 点击「登录」按钮，完成登录 | 登录成功后跳回 `.com.cn` 后缀页面 |

### 4.2 发布内容后跳转

> 发布成功后通过 `processHrefUrl()` 处理跳转目标 URL，需验证该函数是否在当前域名下正确替换了域名。

| # | 场景 | 页面地址 | 预期结果 |
|---|------|---------|---------|
| 1 | 新子域名下发布文章（qcloud-community） | `developer.cloud.tencent.com/article/write-new` | 发布成功后跳转到文章详情页，URL 为新子域名 |
| 2 | 新子域名下发布问答（qcloud-community） | `developer.cloud.tencent.com/ask`（点击提问） | 提交成功后跳转到问题详情页，URL 为新子域名 |
| 3 | 新子域名下发布视频（qcloud-community） | `developer.cloud.tencent.com/creator/publishVideo` | 发布成功后跳转 URL 为新子域名 |
| 4 | 旧路径下发布文章 | `cloud.tencent.com/developer/article/write-new` | 发布成功后跳转 URL 为旧路径格式 |

### 4.3 创作者中心内部跳转

> 创作者中心侧边栏导航、Tab 切换等使用 `location.href` 跳转，不经过 GlobalListener。

| # | 场景 | 页面地址 | 验证操作 | 预期结果 |
|---|------|---------|---------|---------|
| 1 | 切换「我的提问 / 我的回答」Tab | `developer.cloud.tencent.com/creator/ask` | 通过新子域名访问，点击切换 Tab | Tab 切换后 URL 仍为新子域名 |
| 2 | 侧边栏点击「写文章」按钮（新窗口） | `developer.cloud.tencent.com/creator` | 点击侧边栏「写文章」 | 新窗口打开的写作页地址为 `developer.cloud.tencent.com/article/write-new` |
| 3 | 视频管理页点击「编辑视频」 | `developer.cloud.tencent.com/creator/videos` | 点击某条视频的编辑按钮 | 跳转到编辑页 `developer.cloud.tencent.com/creator/editVideo?vlogId=xxx`，URL 为新子域名 |

### 4.4 控制台跳转

> 沙龙签到页和用户通知设置页中，使用 `window.open('https://console.${location.host}/...')` 动态拼接控制台地址，理论上已正确适配，重点验证 `.cn` / `.com.cn` 后缀。

| # | 场景 | 页面地址 | 验证操作 | 预期结果 |
|---|------|---------|---------|---------|
| 1 | 沙龙签到页 - 前往控制台 | `developer.cloud.tencent.cn/salon/salon-{沙龙ID}/signup` | 通过 `.cn` 后缀访问，点击「前往控制台」 | 新窗口打开 `console.cloud.tencent.cn`，不出现 `console.cloud.tencent.com` |
| 2 | 用户通知设置页 - 前往控制台 | `developer.cloud.tencent.cn/user/settings/notification` | 通过 `.cn` 后缀访问，点击「前往控制台」 | 新窗口打开 `console.cloud.tencent.cn` |
| 3 | `.com.cn` 后缀下控制台跳转 | `developer.cloud.tencent.com.cn/user/settings/notification` | 通过 `.com.cn` 后缀访问，点击「前往控制台」 | 新窗口打开 `console.cloud.tencent.com.cn` |

---

## 五、机制四：分享与海报链接生成

> **机制说明**：分享功能生成的链接、海报二维码中的 URL 是字符串拼接产生的，不是 DOM 上的 `<a>` 标签，GlobalListener 不介入，需要代码单独处理当前域名。

| # | 场景 | 页面地址 | 预期结果 |
|---|------|---------|---------|
| 1 | 复制文章分享链接（qcloud-community） | `developer.cloud.tencent.com/article/{文章ID}` | 点击分享按钮，复制的链接域名为新子域名 |
| 2 | 生成文章海报（qcloud-community） | `developer.cloud.tencent.com/poster/article/{文章ID}` | 海报中二维码指向新子域名 |
| 3 | 沙龙分享海报（qcloud-developer） | `developer.cloud.tencent.com/salon/sharing/salon-{沙龙ID}` | 海报中链接/二维码指向新子域名 |
| 4 | 旧路径下分享 | `cloud.tencent.com/developer/article/{文章ID}` | 分享链接域名为旧路径格式 |
| 5 | 微信分享 | 新子域名下文章详情页 | 好友收到的链接为新子域名 |

---

## 六、机制五：登录态（Cookie domain）

> **机制说明**：登录 Cookie 的 `domain` 属性决定了登录态能否在新旧域名之间共享。

| # | 场景 | 验证操作 | 预期结果 |
|---|------|---------|---------|
| 1 | 旧路径登录后，打开新子域名 | `cloud.tencent.com/developer` 登录后，新标签打开 `developer.cloud.tencent.com` | 无需重新登录，登录态共享 |
| 2 | 新子域名登录后，打开旧路径 | `developer.cloud.tencent.com` 登录后，新标签打开 `cloud.tencent.com/developer` | 无需重新登录，登录态共享 |
| 3 | 新子域名下刷新页面 | 登录后刷新 `developer.cloud.tencent.com` | 登录态保持，不丢失 |
| 4 | 退出登录 | 新子域名下点击退出 | 新旧域名下均退出，不出现一边已退出另一边仍登录的情况 |

---

## 七、机制六：SEO canonical 标签

> **机制说明**：服务端根据请求域名输出 canonical 标签，影响搜索引擎收录。
>
> **验证方法**：右键查看网页源代码，搜索 `canonical`。

| # | 访问方式 | 页面地址 | 预期结果 |
|---|---------|---------|---------|
| 1 | 新子域名访问 | `developer.cloud.tencent.com/article/{文章ID}` | `<link rel="canonical">` 的 href 为新子域名格式 |
| 2 | 旧路径访问 | `cloud.tencent.com/developer/article/{文章ID}` | `<link rel="canonical">` 的 href 为旧路径格式 |
| 3 | 新子域名访问（问答） | `developer.cloud.tencent.com/ask/{问题ID}` | `<link rel="canonical">` 的 href 为新子域名格式 |

---

## 八、跨项目跳转

> **机制说明**：从开发者社区跳转到竞赛子站，域名规则应各自保持，不出现混用。

| # | 场景 | 页面地址 | 验证操作 | 预期结果 |
|---|------|---------|---------|---------|
| 1 | 社区跳转到竞赛子站 | `developer.cloud.tencent.com`（新子域名首页） | 悬停/点击导航中的「竞赛」入口 | 跳转到 `competition.cloud.tencent.com`，不出现旧路径 |
| 2 | `.cn` 后缀下跳转竞赛 | `developer.cloud.tencent.cn` | 点击导航中的「竞赛」入口 | 跳转到 `competition.cloud.tencent.cn` |
| 3 | 竞赛跳回社区 | `competition.cloud.tencent.com` 竞赛详情页 | 点击页面中的社区相关链接 | 跳转目标为社区新子域名 `developer.cloud.tencent.com` |

---

## 九、跨后缀一致性（.cn / .com.cn）

> 以上各机制在 `.cn` 和 `.com.cn` 后缀下行为应完全一致，重点回归最容易出问题的场景：

| # | 后缀 | 需回归的机制 | 页面地址 | 验证操作 |
|---|------|-----------|---------|---------|
| 1 | `.cn` | 六个入口冒烟 | `developer.cloud.tencent.cn` | 正常打开首页 |
| 2 | `.com.cn` | 六个入口冒烟 | `developer.cloud.tencent.com.cn` | 正常打开首页 |
| 3 | `.cn` | GlobalListener 链接跟随 | `developer.cloud.tencent.cn` | 悬停首页导航和内容卡片链接，href 应为 `.cn` 后缀 |
| 4 | `.com.cn` | GlobalListener 链接跟随 | `developer.cloud.tencent.com.cn` | 悬停首页导航和内容卡片链接，href 应为 `.com.cn` 后缀 |
| 5 | `.cn` | 登录跳转（高风险） | `developer.cloud.tencent.cn` 任意页面，未登录状态 | 点击登录，完成后回到 `.cn` 域名页面 |
| 6 | `.com.cn` | 登录跳转（高风险） | `developer.cloud.tencent.com.cn` 任意页面，未登录状态 | 点击登录，完成后回到 `.com.cn` 域名页面 |
| 7 | `.cn` | 控制台跳转 | `developer.cloud.tencent.cn/user/settings/notification` | 点击「前往控制台」，打开 `console.cloud.tencent.cn` |
| 8 | `.com.cn` | 控制台跳转 | `developer.cloud.tencent.com.cn/user/settings/notification` | 点击「前往控制台」，打开 `console.cloud.tencent.com.cn` |

---

## 十、异常与边界场景

| # | 场景 | 页面地址 | 预期结果 |
|---|------|---------|---------|
| 1 | 访问不存在的文章 | `developer.cloud.tencent.com/article/不存在的ID` | 返回 404 页面，URL 域名不变 |
| 2 | 访问不存在的问答 | `developer.cloud.tencent.com/ask/不存在的ID` | 返回 404 页面，URL 域名不变 |
| 3 | 新子域名下刷新页面 | `developer.cloud.tencent.com/article/{文章ID}` | 页面正常加载，URL 不发生变化 |
| 4 | 新子域名下使用浏览器前进 / 后退 | 任意页面间跳转后 | URL 保持新子域名格式 |
| 5 | 从外部跳入（微信、微博等） | 新子域名格式的文章链接 | 正常打开，登录态正常 |

---

## 优先级建议

| 优先级 | 机制 / 场景 | 说明 |
|--------|-----------|------|
| P0 | 一、六个入口冒烟 | 基础可用性 |
| P0 | 四-1、登录跳转 | 硬编码风险最高，`.cn` / `.com.cn` 下必测 |
| P0 | 三-1、GlobalListener 导航链接跟随 | 每个页面都有，影响面最大 |
| P1 | 三-3/3-4、GlobalListener 正文内链 / 列表卡片 | 核心内容页链接 |
| P1 | 四-2、发布内容后跳转 | 核心写作流程 |
| P1 | 六、登录态 Cookie 共享 | 新旧域名互通 |
| P2 | 二、SSR 链接（源码验证） | 服务端输出正确性 |
| P2 | 四-3、创作者中心内部跳转 | JS 直接跳转场景 |
| P2 | 五、分享与海报链接生成 | 传播场景 |
| P2 | 八、跨项目跳转（竞赛子站） | 跨站链接 |
| P3 | 七、SEO canonical 标签 | SEO 影响 |
| P3 | 四-4、控制台跳转（理论上已正确处理） | 兜底验证 |
| P3 | 九、跨后缀一致性（.cn / .com.cn） | 后缀回归 |
| P3 | 十、异常与边界场景 | 兜底验证 |

旧路径：https://cloud.tencent.com/developer（及 .cn / .com.cn 后缀）

社区子域名测试方案

前端开发工程

前端

腾讯云开发者社区新增子域名访问方式，提供新旧路径访问支持。测试方案涵盖六大核心机制：SSR链接、客户端动态跳转、登录态共享等，确保新旧域名无缝切换。重点验证.cn/.com.cn后缀一致性，保障登录跳转、分享链接等关键功能稳定运行，提升用户体验和SEO效果。

云服务器

域名注册

服务器

2026采购季 | AI焕新·智启新局

domain

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

社区子域名测试方案-腾讯云开发者社区-腾讯云

社区子域名测试方案

社区子域名测试方案

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐