我帮你整理了这类场景下最常见的排查步骤，按顺序操作大概率能定位问题：

第一步：先抓Azure的详细错误日志（最关键！别瞎猜） #

• 登录Azure Portal找到你的WebApp，进入监测 > 日志流，实时查看应用启动和请求的错误信息，这里会给出具体报错（比如模块缺失、数据库连接超时、权限不足）
• 如果日志流信息不够，去部署中心 > 高级工具 > 启动SSH，进入服务器后查看/home/LogFiles目录下的nodejs.log和application.log，里面有更底层的错误堆栈
• 开启WebApp的诊断设置，把日志输出到存储账户，方便后续回溯分析

第二步：排查数据库连接问题（本地正常但部署后失败的高频原因） #

• 检查SQL Server防火墙规则：Azure SQL默认只允许本地IP访问，需要在Azure SQL的安全 > 防火墙和虚拟网络里，勾选允许Azure服务和资源访问此服务器，或者把WebApp的所有出站IP地址（在WebApp的网络 > 出站IP地址里查看）添加到防火墙白名单
• 验证连接字符串：别把本地的连接字符串硬编码在代码里，应该存在WebApp的配置 > 应用程序设置里，键名要和代码中读取的一致（比如代码用process.env.DB_CONN，就把连接字符串存在应用设置的对应键下，类型选SQLServer）
• 确认SQL账号权限：Azure SQL默认用SQL Server认证，别和本地的Windows认证搞混；同时要确保账号有目标数据库和表的读写权限

第三步：Azure WebApp的Node.js环境配置检查 #

• 对齐Node.js版本：WebApp默认的Node版本可能和你本地开发的不一致，在配置 > 常规设置里设置和本地完全相同的版本（比如本地用v18，Azure也要选v18.x）
• 确认启动命令：如果你的入口文件不是默认的server.js/app.js，要么在配置 > 常规设置里指定启动命令（比如node ./src/index.js），要么在package.json的scripts里添加start命令（比如"start": "node src/index.js"），Azure会自动读取这个命令
• 端口不能硬编码：Azure会分配随机端口，代码里要读取环境变量process.env.PORT，比如const port = process.env.PORT || 3000; app.listen(port)

第四步：部署包与依赖问题排查 #

• 避免本地依赖兼容问题：如果用Visual Studio部署，建议不要直接上传本地的node_modules，而是在Azure开启生成自动化（部署中心设置），让Azure在服务器上自动安装依赖
• 检查package.json依赖：确保所有生产依赖（比如mssql）都在dependencies里，别误放在devDependencies（部署时dev依赖不会被安装）
• 查看部署日志：在Azure Portal的部署中心查看最近的部署记录，看有没有依赖安装失败、文件缺失的报错

第五步：其他常见坑 #

• 检查定价层：免费层（F1）可能因资源不足导致启动失败，临时升级到B1层试试，排除资源限制问题
• 强制SSL连接：如果你的SQL Server要求SSL，连接字符串里要加上encrypt=true参数，否则会被拒绝连接
• 重启WebApp：有时候部署后的缓存问题会导致启动异常，先手动重启一次WebApp试试

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