使用Docker+GitHub Actions部署Next.js电商应用后个人资料页无法加载用户地址

1. 前端请求抓包与代码检查 #

• 打开浏览器DevTools的Network面板，刷新个人资料页，定位获取用户地址的API请求：
  • 查看请求URL是否与预期一致（是否正确拼接NEXT_PUBLIC_API_URL和接口路径）
  • 检查请求状态码（如404/401/500）、响应内容，确认是否存在接口路径错误、权限验证失败或后端服务异常
• 核对前端代码中获取地址的逻辑：确认接口调用的路径、请求方法（GET/POST）是否正确，是否依赖NextAuth会话信息（比如请求头是否携带正确认证token）

2. 容器与后端日志排查 #

• 查看Docker容器运行日志：

  docker logs <你的容器ID或名称>
  

  重点关注后端接口的报错信息（如数据库连接失败、路由未定义、权限校验错误等）
• 进入容器内部检查应用日志：

  docker exec -it <你的容器ID或名称> sh
  

  查看应用目录下是否有日志文件（如logs/目录、.next/logs），或直接查看Node.js的标准输出/错误输出

3. 环境变量验证 #

• 检查容器内环境变量是否正确加载：

  docker exec <你的容器ID或名称> printenv
  

  确认NEXT_PUBLIC_API_URL和NEXTAUTH_URL的值与配置一致，注意：.env中NEXTAUTH_URL = ...的空格可能导致变量值含多余空格，需修正为NEXTAUTH_URL=http://...
• 验证环境变量是否在构建/运行阶段正确传入：确认GitHub Actions部署脚本中是否将.env文件挂载到容器，或通过--env参数传递变量

4. 容器内部网络与接口测试 #

• 在容器内部直接调用地址接口，验证后端服务是否正常响应：

  docker exec <你的容器ID或名称> curl http://localhost:3000/<地址接口路径>
  

  如果容器内请求失败，说明后端服务本身存在问题（如路由未注册、数据库查询错误）；如果请求成功，说明问题出在前端请求逻辑（如跨域、认证token缺失）
• 确认容器端口映射：检查Docker启动命令是否包含-p 3000:3000，确保主机端口与容器端口正确映射

5. Sentry错误信息优化 #

• 检查Next.js项目的Sentry配置：确保next.config.js中开启了sourcemap上传，构建阶段执行了Sentry的sourcemap上传脚本，这样才能捕获到具体的错误代码行
• 验证Sentry初始化是否正确：确认前端代码中Sentry的初始化逻辑覆盖了API请求的错误捕获，比如使用Sentry的fetch或axios拦截器捕获请求错误

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