Azure Linux Web App（Git部署）应用错误排查求助

1. 检查Azure应用服务启动命令 #

• 确认Node后端启动命令配置正确：进入Azure门户的应用服务→配置→常规设置，查看启动命令是否匹配你的后端启动脚本，比如npm start或node server.js（根据实际入口文件调整）。
• 若前后端同部署，需确保后端配置了静态文件服务，比如Express中通过express.static('public')托管React所在的public目录资源。

2. 查看应用运行日志 #

• 进入Azure门户的应用服务→监测→日志流，实时查看后端运行时的报错信息，比如端口冲突、依赖缺失、文件路径错误等。
• 重新核对部署日志的详细内容，即使显示成功，也可能存在被忽略的警告（如依赖安装不完整、构建命令执行异常）。

3. 验证项目结构与路径配置 #

• 确认React构建产物的位置：若使用create-react-app，默认构建产物在build目录，需调整构建命令或Azure静态文件配置，将build设为静态根目录；若自定义public目录，要确保后端能正确访问该目录下的文件。
• 检查后端代码中的文件路径，避免使用相对路径导致Azure环境下工作目录不匹配的问题，尽量使用绝对路径或基于__dirname的动态路径。

4. 检查端口配置 #

• Node后端不要硬编码端口，需改为读取Azure提供的PORT环境变量，比如代码中写const port = process.env.PORT || 3000，避免端口冲突导致服务启动失败。

5. 确认依赖安装完整性 #

• 检查Git Actions部署脚本中是否执行了完整的依赖安装命令，比如npm install（而非仅npm install --production，若开发依赖也需用于构建）。
• 本地测试：删除node_modules和package-lock.json，重新安装后启动项目，排除依赖版本不一致的问题。

6. 本地模拟Azure环境测试 #

• 在本地设置与Azure相同的环境变量（如PORT），启动项目并访问，验证前后端是否能正常交互，排查代码本身的逻辑问题。

内容的提问来源于stack exchange，提问作者Clouie Ckien Caagbay