跟随Diesel入门指南使用SQLite时遇到数据库连接错误

可能的原因及修复步骤 #

• 检查SQLite依赖配置
  确保Cargo.toml中正确添加了Diesel的SQLite特性，依赖块应如下：

  [dependencies]
  diesel = { version = "2.0", features = ["sqlite", "r2d2"] }
  dotenv = "0.15"
  

  执行cargo update同步依赖版本。

• 修正DATABASE_URL格式
  SQLite的连接URL必须以sqlite://前缀开头，你的.env文件里的配置需要改成：

  DATABASE_URL=sqlite:///Users/username/Sandbox/diesel_demo/diesel_demo.db
  

  注意是三个斜杠：前两个是协议标识，第三个对应本地文件路径的起始。

• 检查文件权限
  确保当前用户对目标数据库文件及所在目录拥有读写权限，可执行以下命令修复：

  chmod 644 /Users/username/Sandbox/diesel_demo/diesel_demo.db
  chmod 755 /Users/username/Sandbox/diesel_demo/
  

• 确认迁移已执行
  即使数据库文件存在，也需要确保Diesel的迁移脚本已应用，执行：

  diesel migration run
  

• 排查连接代码逻辑
  确保连接代码正确加载环境变量并使用SQLite专属连接类型，示例代码参考：

  use diesel::sqlite::SqliteConnection;
  use dotenv::dotenv;
  use std::env;
  
  pub fn establish_connection() -> SqliteConnection {
      dotenv().ok();
      let database_url = env::var("DATABASE_URL")
          .expect("DATABASE_URL must be set");
      SqliteConnection::establish(&database_url)
          .unwrap_or_else(|_| panic!("Error connecting to {}", database_url))
  }
  

  重点检查是否加载了.env文件，以及是否误用了其他数据库的连接类型。

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