把 runtimeConfig.public 定性为事故级问题,这点我完全同意;但 grep 和启动断言如果写法不对,反而会带来更多麻烦——比如误报太多,最后大家直接把断言删掉了。
这里有几个实操细节:
1. 断言必须递归遍历。useRuntimeConfig().public 常常是嵌套对象,仅检查顶层键名很容易漏掉 public.upload.oss.secretKey 这类深层配置。可以写一个递归 walk,把完整路径拼出来再匹配 /(secret|token|key|password|passwd|private)/i。另外,建议对值也做一次检查——如果某个 public 值长度超过 32,并且符合 base64 或 hex 特征,就直接告警,这比只检查键名更能发现真问题。server/plugins 里抛错时要注意 if (import.meta.dev) return 跳过,否则开发时的热重载会因为断言反复报错,很难受。
2. try_files 在 alias 上下文中存在历史问题。你这行 try_files $uri =404; 本意很好,但 nginx 某些版本在 alias 目录里处理 try_files 的路径拼接会出错;一旦 location 或 alias 某边的斜杠写法有变化,就会莫名返回 404。更稳的做法是用 root:
location ^~ /_nuxt/ {
root /var/www/nuxt-ssr-demo/.output/public;
try_files $uri =404;
expires 1y;
add_header Cache-Control "public, immutable";
access_log off;
}
这样语义清晰,也避开了 alias 的斜杠问题。
3. Nitro storage 挂 redis 这个思路是对的。提醒一句:缓存层不可用时要能降级、允许失败(fail-open),driver 连不上会直接抛出错误,让 swr 渲染的整条链路都返回 500,比没有共享缓存还危险。建议外层包一层 try/catch,失败就回退到进程内存。
4. titleTemplate 那条补一个坑:app.head 里配了 titleTemplate: '%s - 站点名' 之后,页面里 useSeoMeta({ title }) 只写纯标题,千万别再手动拼后缀,否则出来就是“文章标题 - 站点名 - 站点名”,这类重复后缀很容易被搜索引擎判定为标题堆砌。
见习用户






