vue报错之“Feature flag __VUE_PROD_HYDRATION_MISMATCH_DETAILS__ is not explicitly defined... ”

背景：

使用vue-cli 创建vue项目时控制台出现以下警告：

Feature flag __VUE_PROD_HYDRATION_MISMATCH_DETAILS__ is not explicitly defined. You are running the esm-bundler build of Vue, which expects these compile-time feature flags to be globally injected via the bundler config in order to get better tree-shaking in the production bundle.

For more details, see https://link.vuejs.org/feature-flags.

解释

大体意思就是：

此__VUE_PROD_HYDRATION_MISMATCH_DETAILS__ 未被明确定义。您正在运行Vue的esm-bundler构建版本，这个版本期望在编译时通过bundler配置全局注入这些特性标志，以便在生产捆绑包中获得更好的tree-shaking效果。

在Vue 3.4版本中引入了特性标志__VUE_PROD_HYDRATION_MISMATCH_DETAILS__，是一个编译时的特征标志（feature flag），它用于控制在生产环境下服务器端渲染（SSR）过程中hydration（激活）阶段的错误处理行为。
　　在Vue应用进行SSR时，服务器会预先生成HTML字符串发送到客户端，然后客户端的JavaScript执行时会对这个静态HTML进行 hydration，即把静态HTML转换成可响应数据变化的动态DOM。
　　在这个过程中，如果服务器生成的初始HTML结构与客户端Vue组件渲染出的结构不匹配，就会发生hydration不匹配错误。
　　默认情况下，在生产环境中，Vue通常会简化这类错误报告以提高性能和减少包体积。然而，启用 __VUE_PROD_HYDRATION_MISMATCH_DETAILS__ 标志后，即使在生产环境下，当发生hydration不匹配错误时，Vue也会输出详细的错误信息，这对于调试和排查此类问题非常有用。

解决方案

Vite

// vite.config.js
import { defineConfig } from 'vite'
 
export default defineConfig({
  define: {
    // enable hydration mismatch details in production build
    __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: 'true'
  }
})

Vue-cli

// vue.config.js
module.exports = {
  chainWebpack: (config) => {
    config.plugin('define').tap((definitions) => {
      Object.assign(definitions[0], {
        __VUE_OPTIONS_API__: 'true',
        __VUE_PROD_DEVTOOLS__: 'false',
        __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: 'false'
      })
      return definitions
    })
  }
}

备注

本文参考：cg_ssh       勿忘初心，只道寻常