记一次|记一次 Nuxt 3 在 Windows 下的打包问题

0. 背景
之前用 Nuxt 3 写了公司的官网,包括了样式、字体图标、图片、视频等,其中样式和字体图标放在了 assets/stylesassets/fonts 目录下,而图片和视频则放在了 public/imagespublic/videos 目录下。
1. 起因
在不改变任何 nuxt.config.ts 打包配置的情况下,直接执行 npm run build,会生成一个 .output 目录,结构如下
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

我们再展开 _nuxt 文件夹,结构如下
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

这里有个问题就是 .output/public/ 下和 .output/public/_nuxt/ 下都有 imagesvideos 文件夹,而且里面的内容完全一样,这就造成了发布包体积变大
2. 经过
然后查阅了官网的配置文档,发现 app.buildAssetsDir 可以改变静态资源的输出路径(默认值也的确是 _nuxt),于是将其改成 / 后再次打包,然而并没有任何变化 ?。在仔细看了两遍文档无果后,只能撸起袖子从代码入手,最后在 .output/server/chunks/render.mjs 里发现代码关心的其实是下面的三个配置
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

因此应该调整的是 assetsPath,而不是文档上写的 buildAssetsDir
改完再次打包,发现已成功将 _nuxt 里的内容移到了外面,见下图
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

接着 npm start 启动项目,不出所料的出现了问题 ,大大的 404 欢迎我
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

继续查代码,发现在 .output/server/chunks/static.mjs 里有这么一段代码

if (!asset) { if (id.startsWith(PUBLIC_PATH) && !id.startsWith(STATIC_ASSETS_BASE)) { throw createError({ statusMessage: "Cannot find static asset " + id, statusCode: 404 }); } return }

偏偏我们现在的 PUBLIC_PATH/,这样一来所有不是静态资源且以 / 开头的请求都被拦截到 404 去了 ?。
手工注释掉这段代码,重启服务,再次刷新页面,ok 了。
原以为到这里就结束了,但又发现所有 .mjs 的请求又都变成了 404
记一次|记一次 Nuxt 3 在 Windows 下的打包问题
文章图片

这种批量出问题的,估摸着又是哪里的配置有问题。
再次查看文档,比对代码,发现有个 vite.base 的配置默认是指向 _nuxt 的,赶紧改成 /
再次 build,重启服务,刷新页面,成了!
3. 写在最后
这次排查经历告诉我 ... nuxt 3 真的还没有达到生产环境使用的标准,而且我之前有次在 Linux 下 build,出来的结果和 Windows 下还不一样,这个就以后再讨论了。
【记一次|记一次 Nuxt 3 在 Windows 下的打包问题】拜拜,下次见。

    推荐阅读