ThinkPHP 启用 SQLite 需安装 think-sqlite 扩展、配置绝对路径、设置 PDO 超时、统一正斜杠路径，并确保 CLI 与 Web 环境配置一致及数据库文件可写。
SQLite 扩展没启用，thinkphp 启动直接报错 Driver [sqlite] not supported
ThinkPHP 默认不带 SQLite 驱动，哪怕系统装了 pdo_sqlite，TP 仍会因缺少适配器拒绝启动。核心不是 PHP 是否支持 SQLite，而是 TP 的 think-sqlite 包是否就位。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer require topthink/think-sqlite（注意不是topthink/think-orm自带的那套） - 确认
config/database.php中'type' => 'sqlite'，且'database'指向绝对路径（如/var/www/runtime/db/app.db），相对路径在 CLI 和 Web 下行为不一致 - 检查 PHP CLI 和 Web SAPI（如 Apache mod_php 或 php-fpm）是否都启用了
pdo_sqlite：分别执行php -m | grep sqlite和phpinfo()页面搜索PDO drivers
Web 请求中写入失败，日志里反复出现 SQLSTATE[HY000]: General error: 5 database is locked
SQLite 在并发写入时用文件锁阻塞，而 ThinkPHP 默认连接池为 1、且未配置 busy_timeout，导致高频率请求（比如 AJAX 刷新或表单提交）立刻撞锁。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在数据库配置中显式加
'params' => [PDO::ATTR_TIMEOUT => 5]，单位是秒，别用毫秒 - 避免在事务外做长耗时操作（如调用外部 API、生成大文件），否则锁住时间远超预期
- 若业务允许，把高频写操作合并成批量
INSERT INTO ... VALUES (),(),()，减少锁持有次数 - 切勿在
public/目录下放.db文件——Web 服务器可能直接返回文件内容，且权限易出问题
Windows 下路径斜杠错乱，database 配置写成 runtime\app.db 导致连接失败
ThinkPHP 的 Env 和路径解析在 Windows 上对反斜杠敏感，\ 不会被自动转义，最终拼出的路径被 SQLite 当作非法 URI 处理。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有路径统一用正斜杠
/，即使在 Windows 上也写runtime/app.db - 用
realpath()或think\facade\App::getRuntimePath()动态拼接，例如：database' => App::getRuntimePath() . 'app.db' - 验证路径是否真实可写：在命令行进到项目根目录，执行
php -r "var_dump(is_writable('runtime/app.db'));"，注意文件必须存在才能返回true
迁移命令 php think migrate:run 执行后表建好了，但后续查询始终提示 no such table
根本原因是迁移用的数据库连接和业务代码用的不是同一个 database 文件路径——常见于配置里用了相对路径、环境变量未生效、或 CLI 和 Web 使用不同配置文件。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在迁移前加一行调试：
php -r "echo config('database.connections.sqlite.database');"，确认输出的是你预期的绝对路径 - 检查
config/database.php是否被.env覆盖，尤其留意DB_DATABASE环境变量是否设错（它会覆盖配置里的database值） - SQLite 不支持
DROP TABLE IF EXISTS的标准语法，迁移回滚可能失败；建议开发阶段用php think migrate:reset+ 手动删.db文件更可靠
SQLite 的文件锁机制和路径解析在不同环境差异很大，最常被忽略的是 CLI 和 Web SAPI 加载的配置不一致，以及 .db 文件权限未随运行用户同步更新。
