Tauri打包过程中WixTools与NSIS报错的全面解决方案

最新推荐文章于 2026-03-28 09:45:48 发布

原创

最新推荐文章于 2026-03-28 09:45:48 发布 · 1.1k 阅读

标签

#Tauri #打包 #Windows #桌面应用

1. 为什么你的Tauri应用总是卡在打包这一步？

如果你正在用Tauri开发桌面应用，特别是第一次尝试打包生成Windows安装包（.msi或.exe），那么你大概率会遇到两个“老朋友”：WixTools报错和NSIS报错。这感觉就像你兴冲冲地准备开车上路，结果发现车没油，好不容易加了油，又发现轮胎没气，非常让人沮丧。

我自己刚开始用Tauri时，几乎每次打包都会栽在这两个坑里。控制台里红彤彤的错误信息，什么“Connection Failed”、“invalid peer certificate”，或者干脆就是下载超时，看着就头疼。最关键的是，你可能会发现，即使你给自己的开发环境配置了网络加速工具，这个问题依然纹丝不动。这是因为Tauri的构建工具在后台自动下载这些必要的Windows安装工具时，走的是另一条路，常规的加速方法对它无效。

简单来说，Tauri为了把你的Web应用（比如用Vue、React写的）打包成一个真正的Windows桌面程序，需要借助两个外部的“打包工具”：

Wix Toolset (WiX)：主要负责生成 .msi 格式的Windows安装程序。MSI安装包功能更强大，支持安装、修复、升级、卸载等标准流程。
NSIS (Nullsoft Scriptable Install System)：一个开源的脚本驱动的安装包制作工具，Tauri用它来生成 .exe 格式的安装包。它更灵活轻量。

问题就出在，Tauri的构建脚本（通常是 tauri build 命令）会尝试从GitHub的官方仓库自动下载这两个工具的最新版本。由于众所周知的网络原因，这个下载过程在国内环境下失败率极高。这根本不是你的代码有问题，纯粹是环境问题。好消息是，解决思路很直接：既然自动下载不行，那我们就手动下载，然后“告诉”Tauri东西已经在这儿了，别再去网上找了。接下来，我就带你一步步亲手搞定这两个拦路虎。

2. 手把手解决WixTools下载失败报错

我们先来对付第一个，也是最常见的错误——WixTools报错。当你运行 tauri build 或者 npm run tauri build 时，在构建进程跑了一会儿之后，你很可能会在终端看到类似下面这样的错误信息：

Error failed to bundle project: https://github.com/wixtoolset/wix3/releases/download/wix3141rtm/wix314-binaries.zip: Connection Failed: tls connection init failed: invalid peer certificate: UnknownIssuer

或者也可能是简单的网络超时、连接拒绝。别管错误描述具体是什么，核心原因就一个：那个ZIP包下载不下来。