Nuxt 3 把数据库密码打包进前端:我用 runtime config、服务端接口和环境校验堵住密钥泄露
从构建产物里搜到 MONGO_PASSWORD 开始,我重新划清 public、私有配置和服务端接口的边界,并加了一道上线扫描。

作者
ZHOUYI
上周上线前,我顺手在 .output/public 里搜了一下环境变量名,居然搜到了 MONGO_PASSWORD。那一瞬间很清醒:这不是服务端日志,是可能被浏览器拿到的前端产物。问题不在于密码是否立刻可用,而在于它已经出现在错误的位置:客户端边界被打破了。
密钥是怎么跑到前端的
- 把私有配置塞进 runtimeConfig.public,以为只要叫 config 就会自动保密。
- 页面组件里直接调用数据库工具,或者读取 process.env,构建时被静态分析带进客户端 chunk。
- 为了 SSR 渲染方便,把服务端初始化状态原样注水到 window,前端脚本里也能完整看到。
我改成三条边界
现在我只记三句话:公开配置进 public,私密配置留在 runtimeConfig 根层,浏览器永远只访问服务端接口。Nuxt 的 runtime config 不是保险箱,它只是帮你区分运行环境;真正安全的是不把秘密送到客户端。具体字段和行为以官方文档为准。
落到代码上,我把所有涉及 MongoDB、Redis、支付密钥的读取都移到 server/api 下。页面只请求 /api/posts、/api/order/status 这类接口,接口再返回脱敏后的业务数据。这样即使前端被完全查看,也只能看到结果,看不到连接串。
// nuxt.config.ts
export default defineNuxtConfig({
runtimeConfig: {
mongoUrl: process.env.MONGO_URL,
public: { siteName: '博客' }
}
})
// server/api/posts.get.ts
export default defineEventHandler(async () => {
const config = useRuntimeConfig()
return await getPosts(config.mongoUrl)
})上线前加一道扫描
扫描时我也踩过误报:私有变量会出现在服务端 bundle 里,这是运行需要的,不应一律当成公开泄露。真正要盯住的是 public 目录、浏览器下载的 JS,以及 SSR 输出里的注水内容。如果用了 CDN 或对象存储,还要检查缓存策略,确保 public 目录不会误包含服务端文件。
- 构建后先区分公开产物和服务端产物,只把浏览器可访问的文件当作泄露扫描对象。
- 用 grep 检查 MONGO、REDIS、SECRET、PAY_KEY 等关键词,命中就阻断发布。
- 启动时校验必要环境变量,缺失直接失败,避免线上拿空字符串连错库。
发现泄露后,我没有只删构建产物,而是先轮换数据库和 Redis 密码,再检查 CDN 缓存与历史部署。因为只要曾经上线过,就可能被爬虫或缓存留下。工程上要把事故当成流程漏洞,而不是个人失误。
“这次踩坑让我明白:前端框架不会替你保守秘密,接口边界才是。把密钥从页面里拿掉,比事后删缓存靠谱得多。”