AdonisJS 项目 Docker 部署中 pino-pretty 报错解决方案

问题背景

在使用 AdonisJS 框架开发 Node.js 应用时，很多开发者会选择使用 Docker 容器化部署方案。然而在构建生产环境镜像时，可能会遇到一个关于日志模块的报错："unable to determine transport target for 'pino-pretty'"。

错误现象

当运行构建后的 AdonisJS 应用时，控制台会输出如下错误信息：

Error: unable to determine transport target for "pino-pretty"

   ⁃ fixTarget
     node_modules/pino/lib/transport.js:146
   ⁃ anonymous
     node_modules/pino/lib/transport.js:93
   ⁃ transport
     node_modules/pino/lib/transport.js:90

问题原因

这个问题的根源在于 AdonisJS 默认使用 pino 作为日志系统，而 pino-pretty 是一个用于开发环境下美化日志输出的工具。在 Docker 多阶段构建过程中，当 NODE_ENV 环境变量设置不当时，系统会错误地尝试在生产环境中加载这个开发依赖。

解决方案

1. 正确设置 NODE_ENV 环境变量

在 Dockerfile 的生产环境阶段，必须明确设置 NODE_ENV=production：

FROM base as production
ENV NODE_ENV=production
WORKDIR /app
COPY --from=production-deps /app/node_modules /app/node_modules
COPY --from=build /app/build /app
EXPOSE 8080
CMD ["node", "./bin/server.js"]

2. 检查依赖安装命令

确保在安装生产依赖时使用正确的命令：

RUN npm ci --omit=dev

3. 可选方案：移动 pino-pretty 到 dependencies

虽然不推荐，但在某些特殊情况下，可以将 pino-pretty 从 devDependencies 移动到 dependencies。这种方法虽然能解决问题，但不是最佳实践。

最佳实践建议

1. 严格区分环境：始终确保生产环境明确设置 NODE_ENV=production
2. 多阶段构建：使用 Docker 的多阶段构建来减小最终镜像体积
3. 依赖管理：仔细检查 package.json 中的依赖分类
4. 日志配置：考虑为生产环境配置更适合的日志传输方式

总结

AdonisJS 项目在 Docker 化部署时遇到的这个日志模块问题，本质上是环境配置问题。通过正确设置环境变量和依赖管理，可以轻松解决。理解 Node.js 模块系统在不同环境下的行为差异，是避免类似问题的关键。