You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

修复在 VS Code 中使用内置浏览器时出现的 ERR_CERT_AUTHORITY_INVALID 错误

修复在 VS Code 中使用内置浏览器时出现的 ERR_CERT_AUTHORITY_INVALID 错误

这个错误是由于 VS Code 内置的 Electron Chromium 浏览器不认可本地开发服务器的自签名SSL证书导致的,以下是几种针对性的解决方案:

方法一:信任本地开发环境的SSL证书

不同前端脚手架(如 Create React App、Vite)提供了官方证书信任方式,确保本地证书被系统和 Chromium 信任:

针对 Create React App 项目

在项目根目录执行官方证书信任命令:

# Windows(PowerShell)
$env:NODE_EXTRA_CA_CERTS="$(npm config get cafile)"
npm start

# macOS/Linux
export NODE_EXTRA_CA_CERTS="$(npm config get cafile)"
npm start

# 或直接运行专用信任脚本
npx trust-local-cert

针对 Vite 项目

Vite 会自动生成本地证书,可通过以下步骤信任:

  1. 启动项目后,用系统浏览器访问 HTTPS 本地地址(如 https://localhost:5173
  2. 在浏览器安全提示中选择 高级继续访问
  3. 导出证书(地址栏锁图标 → 证书详细信息复制到文件,选择Base64编码保存为 .pem 文件),后续可导入到VS Code信任存储(见方法三)

方法二:修改VS Code调试配置,使用HTTP而非HTTPS

若无需强制使用HTTPS调试,可切换到HTTP协议:

  1. 打开VS Code 运行和调试面板(Ctrl+Shift+D),创建/编辑 launch.json 文件
  2. 修改 url 为HTTP开头的地址,移除SSL相关配置:
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "chrome",
      "request": "launch",
      "name": "Launch React App",
      "url": "http://localhost:3000", // 替换为你的HTTP本地地址
      "webRoot": "${workspaceFolder}/src"
      // 注释/删除所有SSL相关配置(如"runtimeArgs"中的证书忽略项)
    }
  ]
}

方法三:手动导入证书到VS Code内置浏览器信任列表

  1. 按方法一的步骤导出本地开发证书为 .pem 文件
  2. 打开VS Code设置(Ctrl+,),搜索并勾选 security.enterpriseRoots.enabled,让VS Code复用系统信任的证书
  3. 若仍无效,可在调试配置中添加忽略证书错误的参数(仅用于开发环境):
{
  "configurations": [
    {
      "type": "chrome",
      "request": "launch",
      "name": "Launch with Cert Ignore",
      "url": "https://localhost:3000",
      "webRoot": "${workspaceFolder}/src",
      "runtimeArgs": [
        "--ignore-certificate-errors",
        "--ignore-ssl-errors"
      ]
    }
  ]
}

验证解决效果

完成配置后重启VS Code调试(F5),检查内置浏览器是否能正常加载页面。

⚠️ 注意:--ignore-certificate-errors 参数仅适合开发场景,生产环境绝对不能使用,会带来严重安全风险。

火山引擎 最新活动