在IIS中部署Node+React应用时遇Invalid domain localhost错误求助

错误原因 #

• IIS的CORS配置未放开：Node后端部署在IIS后，默认跨域规则会拒绝localhost这类本地域名的请求，导致运行在localhost的React无法正常调用接口
• Node应用的域名校验拦截：部分Node框架或第三方库（比如身份验证中间件）有域名白名单机制，localhost未被加入允许列表，触发校验失败
• IIS绑定与Node配置不匹配：IIS站点绑定的域名和Node应用监听的域名不一致，比如Node只允许特定域名访问，用localhost访问时就会报错

解决方案 #

1. 给Node应用配置CORS允许localhost #

如果用Express框架，先安装cors包，再在代码里明确允许React的本地地址：

npm install cors

const cors = require('cors');
const express = require('express');
const app = express();

// 允许React开发服务的请求（替换成你的React端口，一般是3000）
app.use(cors({
  origin: 'http://localhost:3000'
}));

// 开发环境也可以直接允许所有localhost开头的请求
// app.use(cors({
//   origin: /^http:\/\/localhost:\d+$/
// }));

app.listen(3001, () => {
  console.log('Server running on http://localhost:3001');
});

2. 更新Node应用的域名白名单 #

如果是框架或第三方库的域名校验导致错误，把localhost加入允许列表：

• 比如用Auth0、JWT校验组件的话，在配置文件里将http://localhost:3000添加到Allowed Origins列表
• 如果是自定义的域名校验逻辑，直接修改白名单数组，加入localhost或对应的本地URL

3. 同步IIS站点绑定与Node配置 #

• 打开IIS管理器，找到部署Node的站点，右键选「编辑绑定」
• 添加或修改绑定为localhost，端口和Node应用监听的端口保持一致（比如3001）
• 确保Node应用监听的是localhost或0.0.0.0，不要限制为特定外部域名：

// 正确写法，允许localhost访问
app.listen(3001, 'localhost', () => {
  console.log('Server running on http://localhost:3001');
});

4. 临时关闭IIS的域名限制（仅开发环境用） #

如果是IIS的请求过滤或URL重写规则拦截了localhost：

• 打开站点的「请求过滤」，检查是否有拒绝localhost的规则，直接删除
• 查看URL重写规则，避免把localhost的请求重定向到其他域名

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