添加DNS记录后自定义域名仍无法在Vercel生效的原因及操作建议

常见原因 #

• DNS记录未同步生效：DNS解析存在全球同步延迟，通常需要15分钟到48小时。你可以在终端用dig 你的自定义域名 A或nslookup 你的自定义域名命令，检查返回的IP是否和Vercel要求的一致，确认记录是否已经被解析服务器识别。
• DNS记录配置有误：对照Vercel后台给出的域名配置要求，检查cPanel里的记录类型（A/CNAME）、主机名、目标值是否完全匹配。比如根域名（如xxx.com）一般用A记录指向Vercel指定IP，子域名（如www.xxx.com）则用CNAME指向Vercel提供的域名。
• Vercel未完成域名验证：仅在DNS服务商添加记录还不够，必须在Vercel应用后台的「设置-域名」中添加该自定义域名，等待Vercel自动验证DNS记录。验证不通过的话，域名无法绑定到你的应用。
• 本地/网络缓存干扰：浏览器或运营商的DNS缓存可能保留了旧记录，导致无法访问。可以尝试清除浏览器缓存，切换网络（比如用手机热点）测试，或者在终端执行ipconfig /flushdns（Windows）、sudo dscacheutil -flushcache（Mac）清除本地DNS缓存。
• SSL证书未生成：如果Vercel还没为你的自定义域名生成SSL证书，HTTPS访问可能会失败（通常显示证书错误），需要在Vercel后台确认证书状态，等待自动颁发或手动触发重新生成。

需要执行的额外操作 #

Vercel端操作： #

1. 进入你的Vercel应用后台，找到「Settings」→「Domains」
2. 点击「Add Domain」输入你的自定义域名，等待系统验证DNS记录
3. 若验证失败，仔细核对Vercel给出的记录要求和cPanel中的配置，确保完全一致（包括记录值的准确性）

cPanel端操作： #

1. 调整DNS记录的TTL值：如果当前TTL设置过高（比如86400秒），临时改成300秒（5分钟）以加快同步速度，生效后再改回原值
2. 排查冲突记录：检查同一主机名下是否存在重复的A/CNAME记录，或者旧的MX/TXT记录干扰，删除或调整冲突项

内容的提问来源于stack exchange，提问作者HizarSajjad