如何修复 Tauri 发布后程序运行时显示 `asset not found: index.html` 的问题

如何修复 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 的问题。如果仍有疑问，欢迎在评论区留言讨论！