CDN 刷新预热任务失败报错 InvalidDomain 怎么解决？

遇到 InvalidDomain 报错，通常是因为提交的域名未在 CDN 控制台添加或状态异常，优先检查域名归属和配置状态。该错误码常见于阿里云 CDN 接口，其他云厂商可能返回类似含义的不同错误码。

先说结论：该错误表明 CDN 服务无法识别请求中的域名，需确认域名已接入且参数格式正确。

先确认域名是否已在当前账号的 CDN 控制台列表中。
先处理API 请求参数中的域名格式，去除 http/https 前缀。
再验证刷新预热任务列表是否显示成功。

快速处理思路

这类报错通常不涉及服务器内部命令，而是云平台控制台或 API 调用参数问题。如果是控制台操作，检查域名列表；如果是 API 调用，检查参数字符串格式。不要反复提交失败任务，以免触发频率限制。注意：InvalidDomain 是阿里云 CDN 典型错误码，腾讯云、AWS 等厂商错误码可能不同，但排查逻辑一致。

为什么会这样

InvalidDomain 字面意思就是“无效域名”。CDN 服务商在接收到刷新或预热请求时，会先校验该域名是否属于当前账号管理的资源。如果域名从未添加过、已被删除、或者处于“配置中”、“已停用”状态，系统都会拒绝请求并返回此错误。此外，API 调用时如果域名带了协议头（如 http://）或多余空格，也会被判定为无效。

分步处理

1. 检查域名接入状态

2. 核对 API 参数格式

如果是通过 API 或 SDK 提交任务，检查 DomainName 参数。标准格式应仅为域名本身，例如 example.com，不要包含 http://、https:// 或末尾斜杠。部分 SDK 需要数组格式，确保没有混入空字符串。

API 请求示例（curl）：

curl -X POST "https://cdn.aliyuncs.com/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "Action=RefreshObjectCaches&ObjectPath=http://example.com/*&ObjectType=directory&Version=2018-05-10" \
  -d "AccessKeyId=YOUR_KEY&AccessKeySecret=YOUR_SECRET&Signature=YOUR_SIGNATURE"

错误响应 Body 示例：

{
  "Code": "InvalidDomain",
  "Message": "The domain provided does not belong to you.",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

3. 确认账号归属与权限

在多账号或资源组场景下，确认当前调用的 AccessKey 或登录账号是否有该域名的权限。子账号可能因权限策略限制无法操作特定域名，需联系主账号检查 RAM 策略。确保 RAM 策略包含以下 Action：

cdn:RefreshObjectCaches（刷新）
cdn:PushObjectCache（预热）

怎么验证是否生效

提交修正后的任务后，进入 CDN 控制台的“刷新预热”任务列表。观察该任务的状态是否从“失败”变为“处理中”或“完成”。如果是 API 调用，检查返回的 HTTP 状态码是否为 200，且响应体中无 InvalidDomain 错误码。

常见坑

1. 协议头多余：API 调用时最容易犯的错误是带了 http://，CDN 接口通常只认纯域名。

2. 子域名混淆：添加了 www.example.com 但未添加 example.com，刷新根域名时会报错，需分别提交。

3. 域名刚删除：如果刚在控制台删除了域名，立即调用 API 刷新可能会因缓存延迟报 InvalidDomain，建议等待几分钟。

4. 空格不可见字符：批量提交域名时，复制粘贴可能带入空格或换行符，导致校验失败，建议先用文本工具清洗。