Express服务器400状态码无法返回自定义JSON消息求助

一、状态码选择：必须用4xx，别用200 #

你的判断完全正确：提交重复ID属于客户端输入/操作错误，绝对应该用4xx类状态码，200是用来表示请求成功的，用在这里语义完全错误，会混淆前端的状态判断逻辑。

如果要更精准，推荐用409 Conflict（资源冲突），它比400更能明确传递“该ID对应的表单已存在，请求与现有资源状态冲突”的含义；当然继续用400也没问题，只是409的语义贴合度更高。

二、解决IIS 10拦截400自定义响应的问题 #

开发环境正常、生产环境出问题，核心原因是IIS默认会替换400等错误状态码的自定义响应，返回它自带的"Bad Request"页面，根本没把你的Express响应传给前端。解决方法是通过web.config配置禁用这个行为：

1. 配置web.config #

在项目根目录创建或修改web.config，添加以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <!-- 关键配置：让IIS透传后端返回的自定义错误响应 -->
    <httpErrors existingResponse="PassThrough" />
    <!-- 确保Node.js的rewrite规则正确指向你的Express入口文件 -->
    <rewrite>
      <rules>
        <rule name="ExpressRoute">
          <match url="/*" />
          <action type="Rewrite" url="server.js" /> <!-- 替换成你的实际入口文件，比如app.js -->
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

• existingResponse="PassThrough"是核心，它告诉IIS不要干预后端返回的错误响应，直接原封不动传给客户端。
• 注意把server.js改成你实际的Express启动文件名。

2. 确认Express的响应逻辑没问题 #

检查你的Express代码，确保400响应的逻辑没有被错误覆盖，比如错误处理中间件是否正确：

// 示例错误处理中间件，确保自定义响应能正常输出
app.use((err, req, res, next) => {
  if (err.message === "Form exists") {
    return res.status(400).json({ status: 400, message: "Form exists" });
  }
  // 其他错误的默认处理
  res.status(err.status || 500).json({
    status: err.status || 500,
    message: err.message || "Internal Server Error"
  });
});

另外，建议用res.json()代替res.send()，更明确地返回JSON格式响应。

3. 排查Axios拦截器（可选） #

如果配置完IIS还是有问题，检查你的axiosInstance有没有响应拦截器篡改了错误对象：

// 确保拦截器不会修改原始错误响应
axiosInstance.interceptors.response.use(
  response => response,
  error => {
    // 不要在这里替换error.response.data，直接reject即可
    return Promise.reject(error);
  }
);

三、验证步骤 #

1. 保存web.config后，重启IIS站点
2. 用Postman测试接口，确认能收到自定义的JSON响应
3. 前端测试，此时error.response.data.message应该能正确拿到"Form exists"

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