Windows下如何用Surrealist Query连接本地文件存储的SurrealDB？

排查步骤及解决办法 #

1. 释放数据库文件锁 #

Tauri应用运行时会锁定SurrealDB文件，导致Surrealist无法访问。先彻底关闭Tauri应用（包括后台残留进程），再重新尝试连接。

2. 修正文件URI格式 #

Windows环境下Surrealist对file URI的处理有特殊要求，试试以下两种格式：

• 带三斜杠的标准file URI：file:///C:/Users/dev/Desktop/LocalVideoLibrary/LocalVideoLibrary/src-tauri/database.db
• 直接使用Windows本地路径：C:\Users\dev\Desktop\LocalVideoLibrary\LocalVideoLibrary\src-tauri\database.db（输入时可将反斜杠替换为正斜杠C:/Users/...）

3. 确认数据库文件实际路径 #

Tauri应用运行时的工作目录可能和预期不一致，代码中的相对路径../database.db可能指向了其他位置：

• 用Windows搜索找到最新修改的database.db文件，确认其实际路径；
• 或在Tauri应用中添加代码输出当前工作目录（比如println!("{}", std::env::current_dir().unwrap())），再用该目录拼接出数据库文件的绝对路径配置Surrealist。

4. 检查版本兼容性 #

Surrealist的客户端版本如果和Tauri应用中依赖的surrealdb版本差异过大，可能出现连接失败：

• 查看Tauri项目Cargo.toml里的surrealdb版本号；
• 对比Surrealist关于页面显示的版本，若差异明显，尝试升级/降级其中一方的版本。

5. 解决权限问题 #

Windows文件权限限制可能导致Surrealist无法访问数据库文件：

• 右键点击database.db，进入「属性」-「安全」，确保当前用户拥有读写权限；
• 尝试以管理员身份启动Surrealist后再连接。

参考信息 #

Tauri应用中的SurrealDB连接代码 #

static DB: Lazy<Surreal<Db>> = Lazy::new(Surreal::init);

#[tokio::main]
async fn main() -> Result<()> {
  DB.connect::<File>("file://../database.db").await?;
  DB.use_ns("namespace").use_db("database").await?;

  tauri::Builder::default()
    .invoke_handler(tauri::generate_handler![
      ipc::video_download,
      ipc::video_create,
      ipc::video_read,
      ipc::video_update,
      ipc::video_search,
      ipc::video_exists,
    ])

当前Surrealist连接配置 #

• Endpoint URL: file://C:/Users/dev/Desktop/LocalVideoLibrary/LocalVideoLibrary/src-tauri/database.db
• 命名空间: namespace
• 数据库: database
• 认证模式: 匿名

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