tauri-errors-build

tauri-errors-build

Quick Diagnosis

When a Tauri 2 build fails, identify the phase first:

Build Pipeline Phases:
1. Frontend build   (beforeBuildCommand)  --> JS/TS errors
2. Cargo compile    (rustc)               --> Rust compilation errors
3. Bundler          (NSIS/WiX/DMG/deb)    --> Platform packaging errors
4. Code signing     (codesign/signtool)   --> Signing/notarization errors

ALWAYS read the FULL error output. The root cause is often buried above the final error message.

NEVER skip cargo clean when troubleshooting persistent compilation errors -- stale build artifacts cause phantom failures.

---

Error Lookup Table: Cargo Compilation

ERR-B001: Command function visibility in lib.rs

Error: error[E0255]: the name X is defined multiple times or cryptic macro expansion errors.

Cause: Command functions defined directly in src-tauri/src/lib.rs are marked pub.

Fix: ALWAYS remove pub from command functions in lib.rs. Commands in separate modules MUST be pub.

// WRONG -- in lib.rs
#[tauri::command]
pub fn greet(name: String) -> String { ... }

// CORRECT -- in lib.rs
#[tauri::command]
fn greet(name: String) -> String { ... }

// CORRECT -- in src-tauri/src/commands.rs (separate module)
#[tauri::command]
pub fn greet(name: String) -> String { ... }

ERR-B002: Missing Serialize on error type

Error: the trait bound MyError: Serialize is not satisfied

Cause: Command return type Result<T, E> requires E to implement serde::Serialize.

Fix: ALWAYS implement Serialize manually for error enums that use thiserror:

#[derive(Debug, thiserror::Error)]
enum AppError {
    #[error(transparent)]
    Io(#[from] std::io::Error),
    #[error("not found: {0}")]
    NotFound(String),
}

impl serde::Serialize for AppError {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where S: serde::ser::Serializer {
        serializer.serialize_str(self.to_string().as_ref())
    }
}