webpack serve启动报wrong tag错误，如何获取更多排查信息？

安全阿岳

2026-9-25

报错根因

这个Error: wrong tag属于Node.js TLS层抛出的证书解析错误，结合输出的DEP_WEBPACK_DEV_SERVER_HTTPS弃用警告判断，是webpack dev server v4+版本中，废弃的旧版https配置项与新版server配置逻辑冲突，导致HTTPS证书读取/解析失败。

更详细的报错信息获取方式

开启Node.js TLS模块调试日志：
如果你用的是Windows PowerShell，执行：
```
$env:NODE_DEBUG="tls,http"
npx webpack serve
```
如果你用的是Windows CMD，执行：
```
set NODE_DEBUG=tls,http
npx webpack serve
```
如果你用的是Mac/Linux终端，执行：
```
NODE_DEBUG=tls,http npx webpack serve
```
该参数会输出TLS握手、证书解析全流程的细节日志，可定位具体是证书文件损坏、格式不合法还是配置字段不匹配。
开启webpack详细运行日志：执行npx webpack serve --stats verbose，会输出dev server从配置加载到初始化的全流程日志，确认你写的HTTPS配置是否被正确识别。

直接修复方案

打开webpack配置文件，删除devServer配置块下的旧版https相关配置（包括https: true、https.cert/https.key等所有和https字段相关的内容）

替换为webpack dev server v4+要求的新版server配置：

module.exports = {
  // 其他配置保持不变
  devServer: {
    // 其他devServer配置保持不变
    server: {
      type: 'https',
      // 如果不需要自定义证书，可直接省略options配置项，dev server会自动生成合法的本地开发证书
      options: {
        cert: './你的自定义证书路径/cert.pem',
        key: './你的自定义证书路径/key.pem'
      }
    }
  }
}

清理dev server缓存的损坏证书：删除日志中提示的C:\Code\pl-security-audit-hub\PrecisionLender.SecurityAuditHub.API\ClientApp\node_modules\.cache\webpack-dev-server文件夹下的所有文件
重新执行npx webpack serve即可正常启动。