Fastify应用POST:/export-excel路由404错误求助

1. 确认路由是否成功注册 #

在服务器启动后打印所有已注册路由，验证POST /export-excel是否存在：

// 在app.listen的then回调中添加打印逻辑
app.listen({
  host: process.env.HOST_IP_ADDRESS ?? '127.0.0.1',
  port: 3333,
}).then(() => {
  console.log('HTTP Server Running!');
  // 打印所有已注册路由
  app.printRoutes();
}).catch((error) => console.log('Error during Data Source initialization:', error));

如果输出中没有POST /export-excel，说明路由未被正确导入或注册。

2. 检查路由文件的导入路径 #

确认主文件中exportExcelRoute的导入路径是否与实际文件位置匹配：

import { exportExcelRoute } from './routes/create-export-excel';

比如主文件在src/目录时，路由文件需存在于src/routes/create-export-excel.ts；使用TypeScript编译时，还要确认编译后的JS文件路径是否正确。

3. 排查插件注册冲突 #

暂时注释fastifyJwt、fastifyCookie等非核心插件，重新启动服务器测试请求，排除插件拦截路由的可能性。你的fastify-static配置前缀为/public/，不会影响/export-excel路由，但也可暂时注释验证。

4. 验证路由定义的正确性 #

确保路由函数是异步且正确绑定到Fastify实例：

export async function exportExcelRoute(app: FastifyInstance) {
  app.post('/export-excel', async (request, reply) => {
    // 路由逻辑
  });
}

同时检查路由函数内是否有未捕获的错误（比如ExcelJS依赖未安装），导致路由注册失败。

5. 核对请求信息 #

确保请求的URL为http://<host>:3333/export-excel，且使用POST方法，没有额外的路径前缀或拼写错误。

内容的提问来源于stack exchange，提问作者Eliria Mirna Bernardo Tolledo