·更新于 2026年11月22日· 46 次浏览 NuxtVue3Node.js工程实践安全BUG解决

Nuxt 3 把数据库密码打包进前端:我用 runtime config、服务端接口和环境校验堵住密钥泄露

从构建产物里搜到 MONGO_PASSWORD 开始,我重新划清 public、私有配置和服务端接口的边界,并加了一道上线扫描。

Nuxt 3 把数据库密码打包进前端:我用 runtime config、服务端接口和环境校验堵住密钥泄露 封面
ZHOUYI

作者

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 这类接口,接口再返回脱敏后的业务数据。这样即使前端被完全查看,也只能看到结果,看不到连接串。

ts
// 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 目录不会误包含服务端文件。

  1. 构建后先区分公开产物和服务端产物,只把浏览器可访问的文件当作泄露扫描对象。
  2. 用 grep 检查 MONGO、REDIS、SECRET、PAY_KEY 等关键词,命中就阻断发布。
  3. 启动时校验必要环境变量,缺失直接失败,避免线上拿空字符串连错库。

发现泄露后,我没有只删构建产物,而是先轮换数据库和 Redis 密码,再检查 CDN 缓存与历史部署。因为只要曾经上线过,就可能被爬虫或缓存留下。工程上要把事故当成流程漏洞,而不是个人失误。

“这次踩坑让我明白:前端框架不会替你保守秘密,接口边界才是。把密钥从页面里拿掉,比事后删缓存靠谱得多。”

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?