Azure部署的Node.js REST API仅curl可用，前端/Thunder Client返回404

1. 核对请求路径的一致性 #

• 前端、Thunder Client等工具可能使用了相对路径，而curl调用用的是完整绝对路径，导致路由不匹配返回404。比如前端请求/api/resources，但实际部署的API根路径是https://your-app.azurewebsites.net/api/v1/resources。
• 解决：所有非curl请求必须使用和curl完全一致的绝对路径，或者确认Express路由前缀（如app.use('/api/v1', router)）在客户端请求中正确包含。

2. 处理OPTIONS预检请求 #

• 浏览器、Thunder Client等会自动发送OPTIONS预检请求，而curl默认不触发。如果API未正确处理OPTIONS请求，会导致预检失败，最终返回404。
• 解决：
  • 使用Express的cors中间件（自动处理OPTIONS及跨域头）：

    const cors = require('cors');
    app.use(cors()); // 默认允许所有源，包含完整OPTIONS处理逻辑
    

  • 手动处理OPTIONS请求（不使用cors中间件时）：

    app.options('*', (req, res) => {
      res.setHeader('Access-Control-Allow-Origin', '*');
      res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
      res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
      res.sendStatus(200);
    });
    

3. 检查Azure App Service的路由配置 #

• Azure主机可能需要额外配置才能正确转发请求到Node.js服务器：
  • Linux主机：在Azure门户的App Service -> 配置 -> 常规设置，确认启动命令正确（如node server.js），且服务器监听Azure分配的端口：

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

  • Windows主机：检查web.config的重写规则，确保所有请求转发到Node.js入口文件：

    <rewrite>
      <rules>
        <rule name="Node.js" stopProcessing="true">
          <match url="(.*)" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
          </conditions>
          <action type="Rewrite" url="server.js" />
        </rule>
      </rules>
    </rewrite>
    

4. 统一请求头格式 #

• curl的请求头（如Content-Type: application/json）可能和其他工具不一致，导致API无法解析请求返回404。比如前端fetch未设置Content-Type，而API路由仅接受JSON格式。
• 解决：确保非curl请求的Content-Type与curl完全一致，示例fetch请求：

  fetch('https://your-app.azurewebsites.net/api/resources', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(data)
  });
  

5. 强制HTTPS请求 #

• 如果API开启了HTTPS强制跳转，但客户端用HTTP请求，会导致跳转后路径丢失返回404，而curl可能自动处理跳转或使用了HTTPS路径。
• 解决：所有客户端请求使用https://开头的路径，同时在Azure门户的App Service -> TLS/SSL设置中开启“HTTPS only”选项。

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