PHP 8.2 默认链接的 libsqlite3 常低于 3.26.0，导致 sqlite3.defensive 失效、WAL 异常及 sqlite_dbpage 不可用；须通过 sqlite3_libversion() 实测版本，独立编译新版 SQLite 并在 PHP configure 时显式指定 --with-sqlite3=/path 确保正确链接。
PHP 8.2 默认绑定的 libsqlite3 版本往往低于 3.26.0，会导致 sqlite3.defensive 配置项失效、WAL 模式异常、sqlite_dbpage 虚拟表不可用等——这不是 PHP 配置问题，而是底层 SQLite 库太老。
确认当前 libsqlite3 实际版本
PHP 自带的 SQLite 支持由编译时链接的系统 libsqlite3 决定，phpinfo() 或 sqlite3_libversion() 返回的是运行时加载的版本，不是源码里写的“支持版本”。必须实测：
- 运行
php -r "echo sqlite3_libversion() . \"\n\";"，输出类似3.11.0就明确过低（需 ≥ 3.26.0） - 检查系统库路径：
ldd $(php-config --extension-dir)/sqlite3.so | grep sqlite，看链接的是/usr/lib/x86_64-linux-gnu/libsqlite3.so.0还是其他路径 - 查该文件版本：
objdump -s -j .comment /usr/lib/x86_64-linux-gnu/libsqlite3.so.0 | grep "SQLite"（部分系统需用strings替代）
源码编译安装新版 SQLite3（非覆盖系统库）
不建议直接 apt upgrade libsqlite3-dev —— Ubuntu/Debian 的仓库长期卡在 3.11–3.35 之间，且升级系统库可能破坏其他软件。稳妥做法是独立编译、让 PHP 显式链接它：
- 下载 SQLite 官方 amalgamation 源码：
wget https://www.sqlite.org/2025/sqlite-autoconf-3400000.tar.gz（以 3.40.0 为例，确保 ≥ 3.26.0） - 解压并编译安装到自定义前缀：
./configure --prefix=/usr/local/sqlite3-340 && make && sudo make install - 验证：
/usr/local/sqlite3-340/bin/sqlite3 --version应输出3.40.0 - 关键：编译 PHP 时显式指定此路径，而非依赖系统默认：
--with-sqlite3=/usr/local/sqlite3-340
重新编译 PHP 8.2 并链接新 SQLite
已有 PHP 8.2 二进制？不能热替换 libsqlite3，必须重编。重点不是“重装”，而是确保 configure 阶段正确识别新库：
立即学习“PHP免费学习笔记（深入）”；
- 进入 PHP 源码目录后，先清理：
make clean && git clean -fdx（避免旧 obj 缓存干扰） - configure 命令中必须包含：
--with-sqlite3=/usr/local/sqlite3-340，且**不能同时出现--without-sqlite3或遗漏该选项** - 编译前确认头文件和库存在：
ls /usr/local/sqlite3-340/include/sqlite3.h和ls /usr/local/sqlite3-340/lib/libsqlite3.so - 编译完成后，运行
php -r "echo sqlite3_libversion();"，应返回新版本；再检查php --ini加载的 php.ini 中sqlite3.defensive=On是否生效（需重启 PHP-FPM）
验证 defensive 模式是否真正启用
即使配置写了 sqlite3.defensive=1，libsqlite3 版本不够或 PHP 未正确链接，它就只是个摆设。最直接验证方式是尝试写入被防护的区域：
- 用
new SQLite3('test.db')打开库后执行：$db->exec("INSERT INTO sqlite_master VALUES(1,2,3,4,5)"); - 如果返回
false且$db->lastErrorMsg()含not authorized或defensive mode字样，说明生效 - 若仍成功写入，说明要么 libsqlite3 太旧，要么 PHP 编译时没链接对路径，或运行时加载了旧的
sqlite3.so - 注意：
sqlite3.defensive是 INI_SYSTEM 级别指令，PHP 8.2.0 起只能在php.ini或httpd.conf中设置，不能用ini_set()
真正麻烦的点不在编译命令本身，而在于 PHP configure 脚本对 --with-sqlite3 的检测非常静默：路径错、权限缺、头文件缺，它常常假装成功，直到运行时才暴露。务必在 configure 后检查 config.log 里有没有 checking for sqlite3_open in -lsqlite3... yes 和对应路径的 checking sqlite3.h usability... yes。
