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 文件权限未随运行用户同步更新。
评论(0)