升级SQLite后PHP出现内部服务器错误的问题求助

问题根源分析 #

你遇到的核心问题是系统库版本冲突：

• 你手动编译安装了新版SQLite（3.40）到系统默认的/usr/local/lib路径，而Ubuntu的库加载优先级中，/usr/local/lib会优先于系统官方库路径/usr/lib。
• 主机提供的PHP 8.0 CGI（php80.cgi）是基于系统旧版SQLite（3.22）编译的，它依赖的SQLite符号与新版库不兼容，导致运行时出现undefined symbol: sqlite3_column_table_name的符号查找错误，最终触发500内部服务器错误。

临时修复：让PHP快速恢复运行 #

如果不想花100美元重装服务器，可以先临时恢复系统默认的SQLite库，让PHP正常工作：

1. 把你安装的新版SQLite库移到临时目录备份：

sudo mkdir -p /tmp/sqlite3-backup/
sudo mv /usr/local/lib/libsqlite3* /tmp/sqlite3-backup/

2. 重启你的Web服务器（以Apache为例）：

sudo systemctl restart apache2

这时候PHP会重新加载系统原有的3.22版本SQLite，你的"Hello World"脚本应该能正常运行了。

正确的SQLite升级方案（避免后续冲突） #

不管是现在修复后，还是重装服务器后，想要安全升级SQLite同时不影响PHP，需要将新版SQLite安装到独立路径，再重新编译PHP的SQLite扩展链接到这个新版库：

步骤1：编译安装新版SQLite到独立路径

不要覆盖系统默认库，把3.40版本安装到/usr/local/sqlite340：

# 创建源码存放目录
sudo mkdir -p /usr/local/src
cd /usr/local/src

# 下载并解压SQLite源码
wget https://www.sqlite.org/2022/sqlite-autoconf-3400000.tar.gz
tar zxvf sqlite-autoconf-3400000.tar.gz
cd sqlite-autoconf-3400000

# 配置编译路径，完成编译安装
./configure --prefix=/usr/local/sqlite340
make
sudo make install

步骤2：重新编译PHP的SQLite3扩展

因为你的PHP是主机提供的8.0版本，需要编译对应版本的SQLite扩展并链接到新版库：

1. 先安装PHP 8.0的开发依赖：

sudo apt install php8.0-dev

2. 下载对应PHP版本的源码（这里以8.0.30为例，你可以替换成你实际的PHP小版本）：

cd /usr/local/src
wget https://www.php.net/distributions/php-8.0.30.tar.gz
tar zxvf php-8.0.30.tar.gz
cd php-8.0.30/ext/sqlite3

3. 编译扩展并指定新版SQLite路径：

phpize
./configure --with-sqlite3=/usr/local/sqlite340
make
sudo make install

步骤3：启用新扩展并重启服务

1. 打开你的PHP配置文件php.ini（可以通过php -i | grep php.ini找到具体路径），找到extension=sqlite3这一行，确保它指向你刚编译的扩展（如果扩展已经在默认extension_dir目录里，直接启用即可）。
2. 重启Web服务器：

sudo systemctl restart apache2

替代方案（无需编译PHP扩展） #

如果不想编译PHP扩展，可以通过LD_PRELOAD让PHP单独加载新版SQLite库，而不影响其他系统软件：
在你的Web服务器配置（比如Apache的虚拟主机配置或者httpd.conf）中添加以下内容：

SetEnv LD_PRELOAD /usr/local/sqlite340/lib/libsqlite3.so

然后重启Web服务器，这样PHP运行时会优先加载指定的新版SQLite库，同时系统其他软件仍使用默认的旧版本。

备注：内容来源于stack exchange，提问作者Michael Bluejay