Rust Web应用运行报错退出码3，排查无效寻求解决方案

1. 开启详细日志输出 #

退出码3通常对应静默错误，先通过日志抓取具体问题：

• 在Cargo.toml添加依赖：

  [dependencies]
  log = "0.4"
  env_logger = "0.10"
  

• 在main函数开头初始化日志：

  use env_logger::Env;
  
  fn main() {
      env_logger::Builder::from_env(Env::default().default_filter_or("debug")).init();
      // 后续启动逻辑
  }
  

• 运行时通过环境变量强制输出debug级日志：

  RUST_LOG=debug cargo run
  

  此时能看到数据库连接、服务启动的详细报错，比如Postgres未启动、连接串错误这类核心问题。

2. 严格检查数据库连接逻辑 #

• 验证Postgres连接串格式：确保是postgres://用户名:密码@localhost:5432/数据库名，无拼写错误，手动用psql命令测试连接是否正常。
• 不要忽略数据库操作的错误返回：给连接、查询代码加上显式错误处理，比如：

  use diesel::prelude::*;
  use diesel::pg::PgConnection;
  
  fn establish_connection() -> Result<PgConnection, diesel::result::Error> {
      let database_url = std::env::var("DATABASE_URL").expect("DATABASE_URL未设置");
      PgConnection::establish(&database_url)
  }
  
  #[actix_rt::main]
  async fn main() {
      match establish_connection() {
          Ok(_conn) => println!("数据库连接成功"),
          Err(e) => eprintln!("数据库连接失败: {}", e),
      }
      // 服务启动逻辑
  }
  

• 确认Diesel迁移已执行：运行diesel migration run确保目标表已创建，避免查询时因表不存在报错。

3. 修复actix-web启动的错误处理 #

actix-web的HttpServer::run()返回Result，忽略会导致静默退出，修改main函数返回错误类型：

#[actix_rt::main]
async fn main() -> std::io::Result<()> {
    env_logger::Builder::from_env(Env::default().default_filter_or("debug")).init();
    
    // 数据库连接逻辑
    let _conn = establish_connection().expect("数据库连接失败");

    HttpServer::new(|| App::new())
        .bind(("127.0.0.1", 8080))? // 用?传播错误
        .run()
        .await
}

此时如果端口被占用、绑定失败，会直接输出具体错误信息，而非返回退出码3。

4. 排查依赖版本兼容性 #

检查Cargo.toml中各依赖版本是否兼容：

• 确保actix-web与actix-rt版本匹配（比如actix-web 4.x对应actix-rt 2.x）
• Diesel的postgres后端需与当前tokio版本兼容（若使用tokio runtime）
• 可以尝试锁定依赖到已知兼容的版本组合，避免版本冲突导致的静默崩溃。

5. 直接运行二进制文件 #

用cargo build编译后，直接执行target/debug/你的应用名，有时cargo会截断输出，直接运行二进制能看到完整的错误日志。

内容的提问来源于stack exchange，提问作者Hải Nghĩa