Azure App Service Linux实例Node.js版本设置不匹配问题排查

• 检查运行栈配置：Linux实例的Node.js版本优先由运行栈设置决定，而非WEBSITE_NODE_DEFAULT_VERSION环境变量。登录Azure门户，进入你的App Service配置页面，在「常规设置」的「运行栈」选项中，确认选择的是Node.js 18 LTS，避免使用默认旧版本或自定义容器。

• 确认部署配置：

  • 若通过GitHub Actions、Azure DevOps等工具部署，检查部署脚本或package.json的engines字段，确保指定了正确版本：

    "engines": {
      "node": "~18.x"
    }
    

  • Azure默认的Oryx构建工具会优先读取package.json的engines配置选择Node.js版本，未指定时可能回退到旧版本。

• 清除容器缓存：Linux实例基于容器运行，旧缓存可能导致版本未更新。可在Azure门户的App Service「概述」页点击「重启」，或在Kudu控制台执行命令强制重建容器：

  az webapp restart --name <你的应用名> --resource-group <你的资源组名>
  

  也可在Kudu「工具」->「高级工具」->「Docker」页面手动清理旧镜像。

• 验证实际运行版本：Kudu调试控制台的node -v输出未必代表应用运行时环境，建议在应用中添加接口输出版本：

  app.get('/node-version', (req, res) => {
    res.send(`Node.js Version: ${process.version}`);
  });
  

  访问该接口确认应用实际使用的Node.js版本。

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