部署Express+Node+MongoDB至Azure遇问题：EJS加载失败且504超时

一、Express应用核心配置修正 #

• 明确EJS视图路径与引擎
  Azure部署环境下默认路径识别可能存在偏差，需在app.js中显式配置：

  const path = require('path');
  // 指定视图文件所在目录
  app.set('views', path.join(__dirname, 'views'));
  // 注册EJS为模板引擎
  app.set('view engine', 'ejs');
  

  确认views文件夹位于项目根目录，所有EJS文件命名无拼写错误。

• 动态监听端口
  Azure通过PORT环境变量分配端口，禁止硬编码固定端口（如3000），修改监听逻辑：

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

二、Azure平台配置调整 #

• 设置启动命令
  在Azure App Service的「配置」>「常规设置」中，将启动命令设为：

  node app.js
  

  若使用package.json的scripts，确保start脚本正确指向app.js后，可设置为npm start：

  "scripts": {
    "start": "node app.js"
  }
  

• 配置数据库环境变量
  在Azure「配置」>「应用程序设置」中添加MongoDB连接字符串，键名与代码中一致（如MONGODB_URI），值为你的数据库连接地址（Azure Cosmos DB for MongoDB需确认连接格式正确）。代码中通过环境变量读取：

  const mongoose = require('mongoose');
  mongoose.connect(process.env.MONGODB_URI)
    .then(() => console.log('MongoDB connected'))
    .catch(err => console.error('MongoDB connection error:', err));
  

• 延长启动超时时间
  504超时多因应用启动初始化耗时过长，在「配置」>「常规设置」中将「启动超时」调整为300秒（5分钟），给数据库连接、应用初始化留足时间。

三、依赖与部署包检查 #

• 确认EJS依赖已声明
  检查package.json的dependencies是否包含ejs，若缺失，本地执行npm install ejs --save后提交至GitHub，Azure部署时会自动安装该依赖。

• 确保部署文件完整
  确认GitHub仓库包含所有核心文件：views文件夹、app.js、package.json、package-lock.json，勿遗漏必要资源。

四、日志排查定位 #

若问题仍存在，查看Azure实时日志流：
进入App Service的「日志流」，查看应用启动与运行时的错误信息，比如EJS文件路径错误、MongoDB连接失败的具体原因，精准定位问题。

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