Webpack 4生产模式构建Node.js服务端代码时MySQL序列错误解决方案咨询

这个问题我之前帮不少开发者处理过，本质是Webpack生产模式默认的压缩混淆逻辑，破坏了MySQL客户端库（比如mysql或mysql2）内部的序列处理机制，导致出现Received packet in the wrong sequence错误。下面给你几个靠谱的解决方案：

• 排除MySQL相关库，不参与Webpack打包
  服务端代码运行在Node.js环境下，完全可以直接引用node_modules里的原生Node模块，不需要Webpack打包它们。在Webpack配置中添加externals配置，让MySQL相关库跳过打包流程：

  module.exports = {
    // 其他配置项...
    target: 'node', // 务必确保target设置为node，适配服务端环境
    externals: {
      'mysql': 'commonjs mysql',
      'mysql2': 'commonjs mysql2'
    }
  };
  

  这样做不仅能避免混淆导致的问题，还能大幅减小服务端打包产物的体积，是最推荐的方案。

• 配置TerserPlugin，跳过MySQL相关文件的混淆
  如果不想完全排除MySQL库，也可以直接让压缩工具跳过对它的混淆处理。Webpack 4生产模式默认使用TerserPlugin，你可以在配置中修改它的参数：

  const TerserPlugin = require('terser-webpack-plugin');
  
  module.exports = {
    optimization: {
      minimizer: [
        new TerserPlugin({
          terserOptions: {
            // 方案1：排除node_modules中的mysql/mysql2目录
            exclude: /node_modules\/mysql|mysql2/,
            // 方案2：如果知道具体被混淆的关键名称，保留它们
            mangle: {
              reserved: ['PacketParser', 'Sequence', 'Connection']
            }
          }
        })
      ]
    }
  };
  

  两种方案选一种即可，排除目录的方式更省心，不需要排查具体的变量名。

• 确认Webpack的target配置正确
  很多开发者容易忽略这一点：服务端代码必须设置target: 'node'，否则Webpack会默认按照浏览器环境打包，替换或模拟Node.js的原生模块（比如net、buffer），而MySQL客户端严重依赖这些原生模块的行为，一旦被篡改就会出现数据包处理错误。所以务必在Webpack配置中加上target: 'node'。

内容的提问来源于stack exchange，提问作者Bram z