pbiviz执行package命令提示证书无效、生成visualPlugin.ts失败如何解决

证书有效性判断 #

你遇到的证书警告不代表当前证书无效，从日志看工具已经检测到旧证书失效，自动生成了新的有效证书，后续报错和证书完全无关。

证书有效性校验步骤 #

• 校验证书文件存在：确认日志中给出的证书路径C:\Users\mike\AppData\Roaming\npm\node_modules\powerbi-visuals-tools\certs\PowerBICustomVisualTest_public.pfx文件真实存在
• 校验系统信任状态：按Win+R输入certmgr.msc打开证书管理器，在「受信任的根证书颁发机构」-「证书」目录下查找名称为Power BI Custom Visuals Test Certificate的证书，查看证书状态是否显示为「该证书没有问题」，且有效期覆盖当前时间
• 工具校验：终端执行pbiviz --create-cert，如果输出证书已存在且有效、无需重新生成即代表证书正常

核心报错根因 #

你日志中最后的error:0308010C:digital envelope routines::unsupported报错是Node.js v17+版本的兼容性问题：Node.js v17开始默认启用OpenSSL 3.0，废弃了旧版加密算法，和当前pbiviz工具的依赖不兼容，才会触发生成visualPlugin.ts失败的报错。

可执行解决方案 #

方案1：临时兼容（无需更换Node版本） #

每次执行pbiviz相关命令前，先在当前终端设置环境变量即可：

• PowerShell终端执行：

$env:NODE_OPTIONS="--openssl-legacy-provider"
pbiviz package

• Cmd终端执行：

set NODE_OPTIONS=--openssl-legacy-provider
pbiviz package

如果需要长期生效，可以把NODE_OPTIONS值为--openssl-legacy-provider添加到Windows系统环境变量中，无需每次新开终端重复设置。

方案2：长期稳定兼容 #

卸载当前Node.js v17.0.0，安装v14或v16的LTS版本（pbiviz官方适配的稳定Node版本），之后重新全局安装powerbi-visuals-tools即可彻底解决问题。

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