Fastify无法收发数据求助：Postman调用/api/user/无响应

核心问题分析 #

1. 错误的路由注册方式

   • 你在api/user/index.js中创建了独立的Fastify实例并导出，但Fastify的register方法需要的是插件函数，而非单独的服务实例，这会导致路由无法正确挂载到主服务。
   • 同时index.js中既执行了fastify.register(router)又手动调用router(fastify)，重复注册会引发服务内部异常。

2. 异步流程顺序错误

   • fastify.listen是异步操作，你未用await等待服务启动完成，且数据库连接connect()在listen之后执行，这会导致接口调用时数据库可能还未建立连接，查询自然无法返回数据。

3. 路由前缀格式问题

   • router.js中前缀写为'api/user'，未以/开头，Fastify路由前缀建议以/开头，避免路径拼接时出现异常。

代码修复方案 #

1. 修改api/user/index.js为插件模式

不再创建新的Fastify实例，改为导出插件函数：

const { createUser, getUsers } = require("./controller");

// 导出插件函数，接收主服务实例与配置选项
module.exports = async function userRoutes(fastify, options) {
  fastify.post("/", async (request, reply) => {
    try {
      const newUser = await createUser(request.body); 
      console.log("新创建的用户数据:", newUser);
      reply.status(201).send(newUser);
    } catch (error) {
      console.error("创建用户失败:", error);
      reply.status(500).send({ error: "内部服务器错误" });
    }
  });

  fastify.get("/", async (request, reply) => {
    try {
      const users = await getUsers();
      console.log("用户列表数据:", users);
      reply.send(users);
    } catch (error) {
      console.error("获取用户列表失败:", error);
      reply.status(500).send({ error: "内部服务器错误" });
    }
  });
};

2. 修正index.js的异步流程与重复注册问题

移除重复的路由注册，确保数据库连接在服务启动前完成，并正确等待服务启动：

const Fastify = require('fastify');
const fastifyCors = require('@fastify/cors');
const router = require('./router');

const fastify = Fastify();
fastify.register(fastifyCors, {
    origin: '*',
    methods: 'GET, PUT, POST, DELETE',
});

// 仅需一次register注册路由
fastify.register(router); 

const { sequelize, config: { host, port } } = require('./config');
const User = require('./api/user/model');

const connect = async () => {
    try {
        await sequelize.authenticate();
        console.log('数据库连接成功');
        // 如需同步模型可取消注释
        // await User.sync();
    } catch (error) {
        console.error('数据库连接失败:', error);
        process.exit(1); // 连接失败直接终止服务
    }
}

const start = async () => {
    try {
        // 先确保数据库连接成功
        await connect();
        // 等待服务启动完成
        await fastify.listen({ port, host });
        console.log(`服务运行在端口 ${port}`);
    } catch (error) {
        console.error('服务启动失败:', error);
        process.exit(1);
    }
}

start();

3. 修正router.js的路由前缀格式

给前缀添加/，避免路径拼接异常：

const user = require('./api/user');

const router = (fastify) => {
    fastify.register(user, { prefix: '/api/user' });
}

module.exports = router;

额外排查建议 #

• 检查getUsers函数的数据库查询逻辑，确保SQL语句或ORM调用无错误；
• 启动服务后查看控制台，确认是否打印数据库连接成功，调用接口时是否输出用户列表数据；
• Postman调用时确认请求方法为GET，路径为http://localhost:3000/api/user/；
• 若之前使用User.sync({ force: true })清空过数据，需重新创建测试数据。

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