Nuxt.js项目如何关闭HTML压缩以保障SSR渲染正常运行

配置不生效的核心原因 #

你之前的配置挂载位置错误：写在build.html节点下的压缩规则，仅对nuxt generate命令产出的静态HTML文件生效，完全不影响SSR服务端动态渲染返回的HTML内容，自然达不到预期效果。

正确配置步骤 #

1. 关闭Nuxt SSR层的HTML压缩 #

根据你使用的Nuxt版本，在nuxt.config.js中添加对应配置：

• Nuxt 2.x 版本（搭配Pug的主流稳定版本）
  将压缩配置移到render节点下，直接关闭minify开关即可，无需单独配置每个压缩规则：

export default {
  // 其他业务配置...
  render: {
    html: {
      minify: false // 完全关闭SSR输出的HTML压缩
    }
  },
  build: {
    // 保留你原有的其他build配置即可
  }
}

如果需要保留部分压缩能力、只关闭特定规则，才需要在render.html.minify下写具体的html-minifier参数，参数格式和你之前写的完全一致，仅需调整挂载位置。

• Nuxt 3.x 版本

export default defineNuxtConfig({
  // 其他业务配置...
  nitro: {
    compressPublicAssets: false,
    minify: false
  },
  routeRules: {
    '/**': {
      headers: {
        'Accept-Encoding': 'identity'
      }
    }
  }
})

2. 同步关闭Pug模板层的压缩 #

如果只关闭Nuxt层的压缩，Pug模板编译阶段默认会输出无格式的压缩HTML，需要同步修改Pug loader配置：

export default {
  // 其他业务配置...
  build: {
    extend(config) {
      const pugRule = config.module.rules.find(rule => rule.test?.test?.('.pug'))
      if (pugRule) {
        pugRule.use.forEach(loader => {
          if (loader.loader.includes('pug-loader') || loader.loader.includes('pug-plain-loader')) {
            loader.options = {
              ...loader.options,
              pretty: true // 保留Pug输出的HTML格式，关闭模板层压缩
            }
          }
        })
      }
    }
  }
}

如果你使用@nuxtjs/pug模块，直接在模块配置项中添加pretty: true即可。

验证方式 #

修改配置后完全停止并重启Nuxt服务（配置文件修改不触发热重载），访问任意SSR路由，右键查看页面源代码：

• 能看到HTML标签保留正常的换行、缩进，没有被压缩为单行
• 页面注水、交互逻辑正常，控制台无SSR相关报错
  即代表配置生效，SSR流程运行正常。

注意：生产环境如果完全关闭HTML压缩，会小幅增加页面传输体积，可根据实际需求在render.html.minify中按需开启不影响业务的压缩规则。

内容的提问来源于stack exchange，提问作者Сергей Гончарь-Лысенко