Fastify CLI创建的项目如何配置logger实现日志写入文件

问题根本原因 #

Fastify 的日志实例在框架初始化阶段就已经完成创建，你在应用插件内部修改 opts 的日志相关配置不会生效——此时日志实例已经存在，插件配置不会覆盖初始化时的logger参数。

正确配置步骤 #

方式1：使用Fastify CLI配置文件（推荐） #

在项目根目录新建 fastify.config.ts（JS项目对应 fastify.config.js），直接配置全局logger参数：

import { join } from 'path'

export default {
  logger: {
    level: 'info',
    // 注意用绝对路径避免路径错误，要确保路径对应的父目录存在
    file: join(__dirname, 'app.log') 
  }
}

如果使用Fastify v4+版本，也可以显式配置transport避免版本兼容问题，还支持自动创建父目录：

import { join } from 'path'

export default {
  logger: {
    level: 'info',
    transport: {
      target: 'pino/file',
      options: {
        destination: join(__dirname, 'app.log'),
        mkdir: true // 开启后自动创建不存在的父目录，无需手动新建
      }
    }
  }
}

方式2：手动实例化Fastify时传入配置 #

如果你是手动编写启动入口，创建Fastify实例时直接传入logger配置即可：

import fastify from 'fastify'
import app from './app'
import { join } from 'path'

const server = fastify({
  logger: {
    level: 'info',
    file: join(__dirname, 'app.log')
  }
})

server.register(app)
server.listen({ port: 3000 })

注意事项 #

• 不要使用纯目录名作为file参数值，必须指定具体的日志文件名，比如./logs/app.log而非./logs
• 尽量使用join(__dirname, 文件名)生成绝对路径，避免相对路径受进程启动目录影响导致日志文件生成位置不符合预期
• 原来插件里的opts.level、opts.file配置可以直接删除，这部分配置完全不会生效

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