在Azure部署Node.js应用遇权限问题及目录加载异常求助

一、为何Azure加载了完整本地目录（含.vscode） #

• 部署文件过滤缺失：检查项目根目录是否有.gitignore文件，确保.vscode、node_modules这类本地配置/依赖目录被排除。如果没有，Azure会同步所有本地文件到服务器。
• SCM构建未正确触发：开启SCM_DO_BUILD_DURING_DEPLOYMENT后，需确认部署方式是通过Git或触发构建的渠道，而非直接手动上传整个目录。如果是VSCode直接同步，可能跳过了构建流程，导致本地文件全量上传。
• Windows环境部署特性：Windows版App Service的部署目录结构和Linux不同，若未通过构建流程处理，会直接保留上传的所有文件结构。

二、根路径无法输出welcome内容的原因 #

• 端口未适配Azure环境：确认你的index.js中，Express服务监听的是process.env.PORT而非固定端口（比如3000）。Azure会动态分配端口，硬编码端口会导致服务无法被外部访问。示例代码：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`Server running on port ${port}`);
  });
  

• 根路由定义问题：检查index.js中是否正确定义了根路径的响应：

  app.get('/', (req, res) => {
    res.send('welcome');
  });
  

• 启动脚本依赖问题：start脚本用了supervisor，这个包属于开发工具，若未安装到生产依赖中，Azure构建时会缺失该包导致服务启动失败。建议生产环境改用node index.js作为start脚本，或者把supervisor添加到dependencies（不推荐生产环境使用开发工具）。
• 默认文档配置：Windows版App Service默认会优先找index.html这类静态文件，若你的服务未正确接管请求，会出现权限提示。可在Azure门户的App Service配置中，将index.js添加到默认文档列表的最顶部。

三、快速修复步骤 #

1. 在项目根目录创建/完善.gitignore，添加以下内容：

   .vscode/
   node_modules/
   .env
   

2. 修改package.json的start脚本为：

   "start": "node index.js"
   

3. 确认index.js中监听process.env.PORT且根路由正确响应。
4. 重新通过VSCode的Azure插件部署，确保触发构建流程（部署时选择"Deploy to Web App"，而非手动上传文件）。

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