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

0. 背景

之前用 Nuxt 3 写了公司的官网，包括了样式、字体图标、图片、视频等，其中样式和字体图标放在了 assets/styles 和 assets/fonts 目录下，而图片和视频则放在了 public/images 和 public/videos 目录下。

1. 起因

在不改变任何 nuxt.config.ts 打包配置的情况下，直接执行 npm run build，会生成一个 .output 目录，结构如下

我们再展开 _nuxt 文件夹，结构如下

这里有个问题就是 .output/public/ 下和 .output/public/_nuxt/ 下都有 images 和 videos 文件夹，而且里面的内容完全一样，这就造成了发布包体积变大。

2. 经过

然后查阅了官网的配置文档，发现 app.buildAssetsDir 可以改变静态资源的输出路径（默认值也的确是 _nuxt），于是将其改成 / 后再次打包，然而并没有任何变化 ‍。在仔细看了两遍文档无果后，只能撸起袖子从代码入手，最后在 .output/server/chunks/render.mjs 里发现代码关心的其实是下面的三个配置

因此应该调整的是 assetsPath，而不是文档上写的 buildAssetsDir。

改完再次打包，发现已成功将 _nuxt 里的内容移到了外面，见下图

接着 npm start 启动项目，不出所料的出现了问题 ，大大的 404 欢迎我

继续查代码，发现在 .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

这种批量出问题的，估摸着又是哪里的配置有问题。

再次查看文档，比对代码，发现有个 vite.base 的配置默认是指向 _nuxt 的，赶紧改成 /。

再次 build，重启服务，刷新页面，成了！

---

3. 写在最后

这次排查经历告诉我 ... nuxt 3 真的还没有达到生产环境使用的标准，而且我之前有次在 Linux 下 build，出来的结果和 Windows 下还不一样，这个就以后再讨论了。

拜拜，下次见。