NextJS部署DigitalOcean生产环境获取旧构建文件触发ERR_ABORTED 404

1. 清理CDN缓存 #

DigitalOcean App Platform默认给自定义域名启用CDN缓存，旧静态资源可能被缓存：

• 进入App Platform控制台，找到目标应用的Domains标签页
• 点击自定义域名旁的Settings，找到Purge Cache选项，清空全部缓存
• 调整缓存策略：对/_next/路径下的资源，利用Next.js哈希文件名特性设置长期缓存；对HTML文件设置短缓存或不缓存，避免页面引用旧资源路径

2. 验证构建与部署配置 #

• 确认构建命令为npm run build（或yarn build），确保.next文件夹生成最新哈希化静态资源
• 启动命令必须用npm start（或yarn start），禁止使用开发环境的next dev
• 查看构建日志，确认无报错，所有静态资源正常生成

3. 检查DNS与SSL配置 #

• 确认自定义域名的CNAME记录指向应用的DO官方域名（如yourapp.ondigitalocean.app）
• 检查SSL证书是否生效，未正确配置可能引发资源加载异常
• 开启HTTP到HTTPS跳转，避免混合内容问题导致资源加载失败

4. 排查浏览器缓存 #

• 强制刷新页面：使用Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）加载最新资源
• 打开开发者工具（F12）的Network标签，勾选Disable cache后重新加载，查看资源请求状态
• 核对请求的/_next/static/路径哈希是否与最新构建匹配，若哈希为旧值，说明浏览器缓存了HTML页面

5. 检查Next.js配置 #

• 确认next.config.js中assetPrefix未错误配置（根路径部署时无需设置）
• 若使用output: 'standalone'，确保App Platform能正确识别独立构建的输出文件

6. 强制重新部署 #

• 在App Platform控制台触发重新部署，勾选Rebuild from scratch清理构建缓存
• 使用DigitalOcean CLI执行命令：doctl apps deploy <app-id> --force-rebuild

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