删除Azure App Service后，无法将自定义域名添加至Azure静态Web应用
2026-8-13
自定义域名迁移至Azure静态Web应用失败的排查方案
以下是你可能遗漏的操作和排查方向：
清理残留的域名验证记录
绑定App Service时通常会添加用于域名所有权验证的TXT记录（格式多为asuid.你的域名或类似），即使删除了App Service，这类记录可能仍留在域名注册商或Azure DNS区域中。需要删除旧的验证TXT记录，再添加静态Web应用要求的新验证记录。解除Azure内部的域名关联残留
有时候删除App Service后，Azure内部的域名关联记录可能未完全清理，可以通过Azure CLI操作：- 登录CLI：
az login - 查询域名关联的资源：
az webapp domain list --query "[?name=='你的自定义域名']" - 如果返回残留记录，执行删除：
az webapp domain delete --name 你的自定义域名
注意：如果是子域名，需确认父域名的关联无残留。
- 登录CLI：
确认静态Web应用的验证配置完整
添加域名到静态Web应用时，不能只修改CNAME记录，必须同时配置对应的验证TXT记录。确保新的TXT记录（静态Web应用提供的asuid.你的域名对应值）已正确添加，且旧的App Service验证记录已删除。强制刷新Azure域名缓存
等待3天可能未触发内部缓存刷新，可通过CLI强制同步：az staticwebapp hostname refresh --name 你的静态Web应用名称 --hostname 你的自定义域名
或在Azure门户的静态Web应用"自定义域名"页面，重新触发验证流程。验证DNS记录的全网传播
用nslookup或dig工具确认新记录已生效：- 检查CNAME：
nslookup 你的自定义域名 - 检查TXT验证记录：
nslookup -type=TXT asuid.你的自定义域名
部分注册商的DNS节点同步可能存在延迟，可更换不同DNS服务器多次验证。
- 检查CNAME：
内容的提问来源于stack exchange，提问作者OneMoreTime
相关产品推荐
相关产品推荐
