Nuxt.js serverMiddleware下划线开头环境变量未定义原因及解决方案
2026-10-6
问题原因
该问题是Nuxt内置的环境变量加载逻辑导致的，Node.js本身是支持下划线开头的环境变量读取的，但Nuxt默认会过滤下划线开头的自定义环境变量，核心原因有两个：
- 避免和 Node.js 内置的下划线开头私有属性（比如
process._exiting、process._tickCallback等）产生命名冲突 - Nuxt 内置的环境变量白名单规则不会将下划线开头的变量纳入加载范围，即便是仅在服务端运行的 serverMiddleware 中，走Nuxt默认加载逻辑也不会把这类变量挂载到
process.env上
如果需要临时验证，可在serverMiddleware中手动加载dotenv读取变量：
// serverMiddleware/index.js require('dotenv').config() console.log(process.env._MY_SECRET) // 此时可正常输出 world
不过该方案不推荐长期使用，容易出现不可预期的变量冲突问题。
可选私有服务变量前缀命名方案
- 用
PRIVATE_作为前缀：例如PRIVATE_MY_SECRET，语义清晰，可明确区分服务端私有变量和可暴露到客户端的公共变量，也适配Nuxt3 runtimeConfig的私有变量命名习惯 - 用
SERVER_作为前缀：例如SERVER_MY_SECRET，直接标注变量仅服务端可用，和客户端公共变量前缀（如Nuxt3的NUXT_PUBLIC_）形成明确区分 - 用
INNER_作为前缀：例如INNER_MY_SECRET，适合标注仅内部服务调用使用的敏感变量，不会被误导出到客户端
内容的提问来源于stack exchange，提问作者DaDo
相关产品推荐
相关产品推荐
