如何修復 Tauri 發布后程序運行時顯示 asset not found: index.html 的問題

在使用 Tauri 發布應用程序時，如果運行時出現 asset not found: index.html 的錯誤，通常是因為 Tauri 無法找到或正確加載前端資源文件（如 index.html）。以下是詳細的修復步驟和解釋。

---

檢查時直接查看 編譯后包所在位置下面有沒有index.html文件生成即可。
路徑比如build,dist等，據配置文件配置指定。

問題原因

1. frontendDist 配置錯誤：tauri.conf.json 中的 build.frontendDist 路徑未正確指向包含 index.html 的前端資源文件夾。
2. 前端資源未正確打包：前端構建工具（如 Vite、Webpack）未將資源文件輸出到 Tauri 預期的目錄。
3. 路徑問題：在開發環境和生產環境中，路徑配置不一致，導致資源加載失敗。

---

修復步驟

1. 檢查 tauri.conf.json 配置

確保 tauri.conf.json 中的 build.frontendDist 路徑正確指向包含 index.html 的文件夾。例如：

{"build": {"frontendDist": "../dist", // 指向前端資源文件夾"devPath": "http://localhost:1420", // 開發環境路徑"beforeDevCommand": "npm run dev","beforeBuildCommand": "npm run build"}
}

• 如果使用 Vite，默認輸出目錄為 dist，確保 frontendDist 路徑正確。
• 如果使用其他工具（如 Webpack），確保路徑與輸出目錄一致。

2. 確保前端資源正確打包

運行前端構建命令，確保資源文件生成到正確目錄。例如：

npm run build

• 檢查 dist 目錄下是否包含 index.html 及其他資源文件。
• 如果 dist 目錄為空，檢查前端構建工具的配置文件（如 vite.config.js 或 webpack.config.js），確保輸出目錄正確。

3. 檢查路徑問題

• 在開發環境中，Tauri 使用 devPath 加載前端資源（如 http://localhost:1420）。
• 在生產環境中，Tauri 使用 frontendDist 加載本地資源文件。
• 確保 index.html 及其依賴的資源文件（如 CSS、JS）路徑正確。

4. 清理緩存并重新構建

有時緩存文件可能導致資源加載失敗，清理緩存并重新構建：

# 清理緩存
rm -rf dist
rm -rf src-tauri/target# 重新構建
npm run build
npx tauri build

5. 檢查文件權限

在部分操作系統（如 Linux）中，文件權限可能導致資源加載失敗。確保 dist 目錄及其文件具有正確的權限：

chmod -R 755 dist

---

示例配置

以下是一個完整的 tauri.conf.json 示例：

{"$schema": "../node_modules/@tauri-apps/cli/schema.json","build": {"frontendDist": "../dist", // 指向前端資源文件夾"devPath": "http://localhost:1420", // 開發環境路徑"beforeDevCommand": "npm run dev","beforeBuildCommand": "npm run build"},"package": {"productName": "MyApp","version": "1.0.0"},"tauri": {"allowlist": {"all": true},"windows": [{"title": "MyApp","width": 800,"height": 600,"resizable": true}]}
}

---

參考文檔

1. Tauri 官方文檔 - 配置前端資源路徑
2. Vite 官方文檔 - 輸出目錄配置
3. Webpack 官方文檔 - 輸出路徑配置

---

版權聲明

本文參考了 Tauri 官方文檔及相關技術文章，結合實踐經驗總結而成。轉載請注明出處和鏈接。

出處: CSDN - 如何修復 Tauri 發布后程序運行時顯示 asset not found: index.html

作者:i建模

版權聲明: 本文為博主原創文章，遵循 CC 4.0 BY-SA 版權協議，轉載請附上原文出處鏈接和本聲明。

---

通過以上步驟，您應該能夠成功修復 Tauri 發布后程序運行時顯示 asset not found: index.html 的問題。如果仍有疑問，歡迎在評論區留言討論！