Node.js配置子域名API后请求无法触发函数的解决方法

1. 先确认子域名配置是否生效 #

开发环境下，首先需要在本地hosts文件中添加映射，让api.example.com指向本地服务器：

127.0.0.1 api.example.com

然后检查server.js中的中间件配置顺序，express-subdomain必须在其他路由前挂载，同时要确保添加了JSON请求体解析中间件：

const express = require('express');
const subdomain = require('express-subdomain');
const apiRouter = require('./_helpers/api');
const app = express();

// 挂载子域名路由
app.use(subdomain('api', apiRouter));
// 解析JSON请求体（POST请求必备）
app.use(express.json());

app.listen(3000, () => console.log('Server running on port 3000'));

可以先用GET请求测试子域名是否能访问：

curl http://api.example.com:3000

如果返回404，说明子域名路由配置未生效，需要检查中间件挂载顺序或包依赖是否正确安装。

2. 验证API路由的POST配置 #

检查_helpers/api.js中的路由代码，确保POST路由绑定正确，且没有遗漏请求体解析（如果server.js没全局配置，这里要单独加）：

const express = require('express');
const router = express.Router();

// 若全局未配置json解析，在此单独添加
router.use(express.json());

router.post('/', (req, res) => {
  // 这里添加你的业务逻辑，先打印日志确认是否触发
  console.log('POST请求已触发');
  res.status(200).json({ success: true, data: req.body });
});

module.exports = router;

3. 正确触发POST请求的方式 #

用curl直接测试最直观，确保请求方法、请求头和地址正确：

curl -X POST -H "Content-Type: application/json" -d '{"username":"test"}' http://api.example.com:3000

如果是前端用fetch调用，要注意跨域问题（开发环境可添加cors中间件），以及请求参数的格式：

// 前端fetch示例
fetch('http://api.example.com:3000', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ username: 'test' }),
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));

若存在跨域，在server.js中添加cors中间件：

const cors = require('cors');
app.use(cors());

4. 排查其他潜在问题 #

• 确认服务器监听的端口和请求端口一致；
• 查看服务器控制台日志，若没有请求记录，说明子域名解析或路由挂载有问题；
• 检查是否有其他中间件（如权限验证）拦截了POST请求。

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