Next.js项目使用Pino v8.7.0时出现传输目标无法确定错误

核心问题 #

1. 浏览器环境限制：客户端（浏览器）没有直接写入本地文件系统的权限，Pino的文件传输功能仅适用于Node.js服务端环境。
2. Transport配置错误：你把文件名作为target传入，而Pino的target需要指定传输模块（比如官方的pino/file），不是文件名。
3. Logger实例混乱：代码中创建了两个独立的Logger实例，逻辑冲突，没有关联起来。

正确实现方式 #

要实现客户端日志写入文件，需要通过API转发：客户端将日志发送到Next.js的API路由，在服务端用Pino写入文件。

1. 客户端Logger配置（pino-logger-service.ts） #

import pino from 'pino';

export const initLogger = () => {
  return pino({
    serialize: true,
    formatters: {
      level(label) {
        return { level: label };
      }
    },
    browser: {
      write: async (obj) => {
        // 将日志发送到Next.js API路由
        try {
          await fetch('/api/log', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify(obj),
            keepalive: true // 保证页面卸载时日志仍能发送
          });
        } catch (err) {
          // 发送失败时降级到控制台输出
          console.error('日志发送失败:', err);
          console.log(JSON.stringify(obj));
        }
      }
    }
  });
};

2. 服务端API路由 #

Pages Router 版本（pages/api/log.ts）

import pino from 'pino';
import { NextApiRequest, NextApiResponse } from 'next';

// 服务端初始化带文件传输的Logger
const logger = pino({
  transport: {
    target: 'pino/file',
    options: {
      destination: './logs/client-logs.log', // 日志文件路径
      mkdir: true // 自动创建不存在的目录（Pino v8+支持）
    }
  }
});

export default function handler(req: NextApiRequest, res: NextApiResponse) {
  if (req.method === 'POST') {
    const logData = req.body;
    // 根据日志级别调用对应方法输出
    logger[logData.level]?.(logData);
    res.status(200).json({ success: true });
  } else {
    res.setHeader('Allow', ['POST']);
    res.status(405).end(`Method ${req.method} Not Allowed`);
  }
}

App Router 版本（app/api/log/route.ts）

import pino from 'pino';
import { NextResponse } from 'next/server';

const logger = pino({
  transport: {
    target: 'pino/file',
    options: {
      destination: './logs/client-logs.log',
      mkdir: true
    }
  }
});

export async function POST(request: Request) {
  const logData = await request.json();
  logger[logData.level]?.(logData);
  return NextResponse.json({ success: true });
}

注意事项 #

• 确保运行项目时，./logs目录存在，或者开启mkdir: true让Pino自动创建。
• 客户端使用keepalive: true可以避免页面跳转/卸载时日志请求被取消。
• 服务端的target: 'pino/file'是Pino内置的文件传输模块，无需额外安装依赖。

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