Rust sqlx连接SQLite时如何在首次启动自动创建数据库文件

sqlx 的 SQLite 驱动默认行为和 rusqlite 不同，直接使用普通连接串时不会自动创建不存在的数据库文件。你遇到的unable to open database file错误，通常由两种情况触发：

• 目标数据库文件不存在
• 数据库文件所在的父目录不存在，或当前运行用户对目标路径没有读写权限

方法1：通过连接参数开启自动创建（最推荐） #

SQLite 连接 URI 支持mode参数，传入rwc（read-write-create）即可实现和 rusqlite Connection::open完全一致的行为：文件存在则以读写模式打开，不存在则自动创建。
你只需要修改连接串，追加参数即可：

use sqlx::sqlite::SqlitePoolOptions;

SqlitePoolOptions::new()
    .max_connections(1)
    .connect(&format!("sqlite://{}?mode=rwc", db_filename))
    .await
    .map_err(|err| format!("{}\nfile: {}", err.to_string(), db_filename))?;

mode参数的其他可选值参考：

• ro：只读模式，文件不存在直接报错
• rw：读写模式，文件不存在直接报错
• rwc：读写+自动创建模式
• memory：内存模式，不生成磁盘文件

方法2：手动预创建文件兜底 #

如果不依赖连接参数的自动创建逻辑，也可以在初始化连接池前手动校验路径、创建缺失的目录和文件：

use std::fs::File;
use std::path::Path;

let db_path = Path::new(db_filename);
// 递归创建不存在的父目录
if let Some(parent) = db_path.parent() {
    std::fs::create_dir_all(parent)?;
}
// 不存在则创建空数据库文件
if !db_path.exists() {
    File::create(db_path)?;
}

// 后续正常初始化SqlitePool即可

• 路径问题：尽量将数据库路径转为绝对路径后再传入连接串，避免程序启动工作目录和预期不一致，导致文件被创建到错误位置。注意类Unix系统下绝对路径生成的连接串会自动带三个斜杠（如sqlite:///var/lib/app/my.db?mode=rwc），属于正确格式，无需额外修改。
• 权限问题：如果数据库存放在系统目录（如/var/lib/、/etc/下），需要提前给程序运行用户分配目标目录的读写权限，否则即使文件存在也会报连接错误。

内容的提问来源于stack exchange，提问作者cdaringe