// SQLite 错误参考

SQLITE_CANTOPEN:无法打开数据库文件

SQLite 无法打开数据库文件或其临时文件之一:路径错误、目录不存在、权限问题或路径是一个目录。

结果代码
SQLITE_CANTOPEN
名称
14
类别
主要结果代码
错误信息
unable to open database file

它的意思

SQLITE_CANTOPEN (14) 表示操作系统拒绝打开 SQLite 需要的文件。通常这是主数据库文件,但也可能是临时文件。当路径不存在时,SQLite 会创建一个新的数据库文件,因此此错误通常意味着目录不存在或不可写,而不是文件丢失。

扩展错误代码可以进一步缩小范围,例如 SQLITE_CANTOPEN_ISDIR (路径是一个目录)和 SQLITE_CANTOPEN_FULLPATH (无法解析完整路径)。

常见原因

  • 路径中的目录不存在;SQLite 创建的是文件,而不是目录。
  • 相对路径会按意想不到的工作目录解析,例如在服务或测试运行器中。
  • 没有读取该文件或在该目录中创建它的权限。
  • 路径指向一个目录(SQLITE_CANTOPEN_ISDIR).
  • 临时目录不存在或不可写,因此无法创建临时文件。
  • 进程中打开的文件过多。

如何修复它

  1. 使用绝对路径,并确保路径中每一级目录都存在。

  2. 检查文件及其目录的权限,确保程序运行的用户有权限。

  3. 如果临时文件是问题所在,请将 SQLite 指向一个可写目录,使用 SQLITE_TMPDIR 或者 TMPDIR 环境变量,或者把临时存储放在内存里。

    PRAGMA temp_store = MEMORY;
  4. 在 sqlite3 shell 中,确认打开了哪些内容。

    .databases

相关错误

更多主要结果代码错误

代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQLite

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。