Azure Function（Express编写）使用application/json时无响应问题

DevOps 小满

2026-5-26

排查Express.js Azure Function处理application/json请求无响应的问题

我来帮你一步步梳理可能的原因和解决办法：

确认Express应用与Azure Function触发器的绑定是否正确
Azure Function集成Express需要借助@azure/functions-express包，并且在入口文件中正确将Express实例绑定到Function的HTTP触发器上。如果没有这一步，你的Express路由根本不会被Azure的请求触发。检查你的入口代码是否类似这样：

const { app } = require('@azure/functions');
const express = require('express');
const server = express();

// 你的中间件配置
server.use(bodyParser.json());
server.use(bodyParser.urlencoded({ extended: false }));
server.use(cors());

// 你的路由定义
server.get('/test', (req, res) => {
  return res.status(200).send({ result: req.query });
});
server.post('/test', (req, res) => {
  return res.status(200).send({ result: req.body });
});

// 关键：将Express服务器绑定到Azure Function的HTTP触发器
app.http('apiEndpoint', {
  methods: ['GET', 'POST'],
  authLevel: 'anonymous',
  handler: server,
});

如果缺少最后这段绑定逻辑，请求会找不到对应的处理逻辑，自然无响应。

检查请求端点是否正确
Azure Function的HTTP触发器默认带有/api前缀，除非你在host.json里修改了routePrefix配置。所以你的完整请求URL应该是https://<你的函数应用名>.azurewebsites.net/api/test，而不是直接访问/test。如果请求路径写错了，也会导致无响应。
排查CORS配置冲突
虽然你在代码里加了cors()中间件，但Azure Portal的函数应用全局CORS设置可能会覆盖或冲突。你可以登录Azure Portal，进入你的Function App → API → CORS，检查是否允许你的请求来源（临时设为*测试是否是CORS问题）。如果OPTIONS预检请求失败，浏览器会阻止后续的POST请求，表现为无响应。
查看函数日志定位错误
无响应往往是因为代码抛出了未捕获的异常，你可以通过以下方式查看日志：
- 登录Azure Portal，进入Function App → 监控 → 日志，查看实时请求日志
- 使用Azure CLI命令az functionapp log tail --name <你的函数应用名> --resource-group <资源组名>查看实时日志
  日志里会显示请求是否到达、有没有解析错误、路由是否匹配等关键信息，帮你快速定位问题。
确保中间件顺序和错误处理正确
确认bodyParser.json()是在路由定义之前挂载的，这样请求体才能被正确解析。另外，添加一个全局错误处理中间件，避免未捕获异常导致函数挂起：
```
server.use((err, req, res, next) => {
  console.error('请求处理出错:', err.stack);
  res.status(500).send({ error: '服务器内部错误' });
});
```
这样即使有错误，也会返回明确的错误响应，而不是无响应。

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