如何Mock Fastify插件？注册AutoLoad路由插件后Mock失败求解决方案

当Fastify通过AutoLoad自动加载路由后Mock失效，本质是真实路由与Mock路由的加载顺序或冲突导致的，以下是几种可行的解决办法：

1. 调整注册顺序并使用路由覆盖选项 #

Fastify默认不允许重复注册相同方法+路径的路由，但从v3.14.0开始支持overwrite选项强制覆盖。只需在注册Mock路由时添加该选项，确保Mock路由在AutoLoad之后注册：

// 先加载真实路由
fastify.register(AutoLoad, {
  dir: path.join(__dirname, 'routes')
})

// 注册Mock路由，覆盖真实路由
fastify.get('/api/user', { overwrite: true }, async (req, reply) => {
  return { id: 999, name: 'Mock User' }
})

2. 测试环境单独加载Mock路由目录 #

通过环境变量区分生产/测试环境，让AutoLoad在测试时加载Mock路由目录，而非真实路由目录：

const routeDir = process.env.NODE_ENV === 'test' 
  ? path.join(__dirname, 'mock-routes') 
  : path.join(__dirname, 'routes')

fastify.register(AutoLoad, { dir: routeDir })

你可以在mock-routes目录下创建与真实路由路径一致的文件，实现完全Mock。

3. 忽略AutoLoad中的真实路由 #

如果不想单独维护Mock目录，可通过AutoLoad的ignore选项在测试环境中跳过真实路由文件，再手动注册Mock：

fastify.register(AutoLoad, {
  dir: path.join(__dirname, 'routes'),
  // 测试环境下忽略所有真实路由文件（示例规则，可根据文件名调整）
  ignore: process.env.NODE_ENV === 'test' ? ['*.js'] : []
})

// 手动注册所有需要Mock的路由
fastify.get('/api/user', async (req, reply) => {
  return { mockData: 'test' }
})

4. Mock路由依赖的服务而非路由本身 #

如果你的路由是通过调用内部服务/函数实现的，直接Mock这些依赖比Mock整个路由更简洁：

// 真实路由文件 routes/user.js
module.exports = async function(fastify) {
  fastify.get('/api/user', async () => {
    return fastify.userService.getUserInfo()
  })
}

// 测试代码中Mock userService的方法
const sinon = require('sinon')
sinon.stub(fastify.userService, 'getUserInfo').resolves({ id: 1, name: 'Mocked Name' })

这种方式不需要修改路由注册逻辑，只需拦截业务逻辑的依赖即可。

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