如何在Fastify中为同一路由同时配置静态服务与自定义JSON路由？

你遇到的问题本质是Fastify的路由匹配优先级问题——当你注册了同路径的自定义路由后，它会优先于静态服务的自动路由被匹配，导致所有请求都走自定义逻辑。要实现基于Content-Type头的分支处理，有两种简洁的方案：

方案1：利用Fastify路由约束（Route Constraints） #

Fastify支持通过路由约束来匹配特定请求头的请求，这样只有符合条件的请求才会触发你的自定义路由，其他请求依然走静态服务的逻辑。

实现步骤： #

1. 先注册带约束的自定义路由：指定仅匹配Content-Type为application/json的请求
2. 再注册fastify/static服务：确保静态服务处理其他所有请求

代码示例：

// 先注册带Content-Type约束的自定义路由
fastify.get('/object/:id', {
  constraints: {
    headers: {
      'content-type': 'application/json'
    }
  }
}, async function (request, reply) {
  // 你的自定义逻辑：根据id获取数据
  const obj = await yourFetchFunction(request.params.id);
  return reply.type('application/json').send(obj);
});

// 再注册静态服务，根目录为STATIC_FOLDER
fastify.register(require('@fastify/static'), {
  root: STATIC_FOLDER,
});

方案2：在自定义路由内手动判断请求头 #

如果你需要更灵活的匹配（比如兼容application/json; charset=utf-8这类带后缀的Content-Type），可以直接在路由 handler 里判断请求头，分支处理逻辑。

实现步骤： #

1. 注册静态服务（不需要特殊配置）
2. 注册自定义路由，在内部判断Content-Type：
   • 符合条件时执行自定义JSON逻辑
   • 不符合时手动调用静态文件发送逻辑

代码示例：

// 注册静态服务
fastify.register(require('@fastify/static'), {
  root: STATIC_FOLDER,
});

// 注册统一的/object/:id路由
fastify.get('/object/:id', async function (request, reply) {
  const contentType = request.headers['content-type'];
  
  // 判断Content-Type是否包含application/json（兼容带charset的情况）
  if (contentType && contentType.toLowerCase().includes('application/json')) {
    // 自定义JSON逻辑
    const obj = await yourFetchFunction(request.params.id);
    return reply.type('application/json').send(obj);
  } else {
    // 手动发送静态文件：对应STATIC_FOLDER/object/<id>/index.html
    return reply.sendFile(`object/${request.params.id}/index.html`);
  }
});

关键注意事项 #

• 路由注册顺序：Fastify按注册顺序匹配路由，方案1中必须先注册带约束的自定义路由，再注册静态服务，否则静态服务的路由会优先匹配。
• Content-Type的兼容性：实际请求中Content-Type可能带有charset后缀（如application/json; charset=utf-8），方案2的includes判断比严格相等更健壮。
• 静态服务的自动索引：fastify/static默认会自动查找目录下的index.html，所以方案1中静态服务会自动处理非JSON请求的/object/:id路径。

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