ThinkPHP8连接SQLite需三步：一装topthink/think-sqlite扩展（TP默认不带），二配绝对路径DSN格式为sqlite:/abs/path/to/db.db（禁用相对路径、反斜杠、空格中文），三清空hostname等无关字段；缺一即报Driver not found或Unable to open database file。
ThinkPHP8 连接 SQLite 不是“开箱即用”，必须装扩展、配绝对路径、写对 DSN，三者缺一不可；否则必报 Driver not found: sqlite 或 SQLSTATE[HY000]: Unable to open database file。
为什么 composer require topthink/think-sqlite 是第一步
TP8 默认不带 SQLite 驱动 —— 即使 PHP 已启用 pdo_sqlite 扩展，框架仍会因缺少适配器拒绝启动。这不是 PHP 层的问题，而是 TP 的驱动注册机制要求显式引入包。
- 执行
composer require topthink/think-sqlite（注意不是think-orm自带的） - 检查
vendor/topthink/think-sqlite目录是否存在 - 确认
config/database.php中'type' => 'sqlite'已设置，否则扩展不会被加载
dsn 必须是 sqlite:/absolute/path/to/db.db 格式
TP8 的 PDO SQLite 驱动靠 dsn 字符串前缀识别协议类型。只设 type => 'sqlite' 但漏掉 dsn，或把 dsn 写成相对路径、Windows 反斜杠、甚至纯文件名，都会导致连接静默失败或报错 Unable to open database file。
- 正确写法只有一种：
'dsn' => 'sqlite:' . app()->getRuntimePath() . 'db/app.db'（注意单斜杠，不是双斜杠） - Windows 下也必须用正斜杠，
runtime\app.db会被解析为非法 URI -
__DIR__ . '/../runtime/db/app.db'比硬编码路径更安全，但需确保runtime/db/目录已存在且可写 - 路径中不能含空格或中文；文件名建议全英文+下划线
配置里必须清空 hostname、username、password 等字段
SQLite 是嵌入式数据库，不走网络协议，也不需要用户认证。这些字段若残留（哪怕值为空字符串），TP 在初始化连接时可能尝试绑定无效参数，引发不可预测的异常。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/database.php的 SQLite 配置块中，删掉或显式设为''： 'hostname' => '''username' => '''password' => ''-
'database' => ''（这个字段对 SQLite 无意义，留着反而干扰）
CLI 和 Web 环境路径不一致是最隐蔽的坑
迁移命令 php think migrate:run 在 CLI 下运行，工作目录通常是项目根目录；而 Web 请求由 Apache/Nginx 触发，工作目录可能是 public/。若你用相对路径如 runtime/db/app.db，两者实际打开的文件根本不是同一个。
- 执行
php -r "var_dump(config('database.default.dsn'));"验证 CLI 下读到的 DSN 是否是你预期的绝对路径 - 在 Web 页面加一行
var_dump(config('database.default.dsn'));，对比是否一致 - 确保
runtime/db/目录存在，且 Web 服务器进程（如www-data）对该目录有读写权限 - 别用
:memory:做生产配置——它每次请求新建库，数据完全不持久
最常被忽略的是：迁移建表和业务查询连的根本不是同一个文件。路径没对齐，no such table 就永远在等你。
