frankenphp静态二进制禁用dlopen，pdo_mysql无法通过extension=加载；验证需用file/ldd命令确认静态链接；可行方案为换docker官方镜像、改用动态构建版或改用内置sqlite驱动。
frankenphp -m 显示 pdo_mysql 缺失，但 php.ini 里已写 extension=pdo_mysql
这是最典型的“以为启用了，其实没加载”现象。FrankenPHP 静态二进制根本不会执行 extension= 这类指令——它禁用 dlopen()，所有动态扩展（包括 pdo_mysql.so）在启动时就被跳过，且不报错。
验证方法很简单：frankenphp -m 输出里没有 pdo_mysql，基本就能确定是静态限制，不是配置路径或拼写错误。
- 别去改系统级
/etc/php/*/cli/php.ini，FrankenPHP 默认不读这些路径 -
php --ini显示的 Loaded Configuration File 路径，才是它真正看的文件（通常是内置路径如/usr/local/lib/php.ini） - 即使你把
pdo_mysql.so文件复制到extension_dir下，也毫无意义——file frankenphp若显示statically linked，就代表它压根不支持dlopen
确认你的 FrankenPHP 是不是真静态二进制
很多问题根源不在扩展本身，而在你误用了“静态”版本却期待它有动态能力。必须用底层命令确认：
- 运行
file frankenphp，输出含statically linked→ 确实是完全静态，无法加载任何.so - 运行
ldd frankenphp，若报错not a dynamic executable→ 再次确认是静态版 - 运行
frankenphp php-cli -r "echo PHP_ZTS ? 'ZTS' : 'NTS';"，输出NTS→ 同时排除 ZTS 扩展兼容性干扰
只要前两条任一成立，就别再折腾 extension= 行了——那行代码在 FrankenPHP 启动流程里根本不会被解析。
实际能用的三种补救路径
不是“怎么让静态二进制加载扩展”，而是“换哪条路能让 PDO 正常工作”。三条路径对应不同约束条件：
- 用官方镜像 +
install-php-extensions：只适用于 Docker 场景，基础镜像是dunglas/frankenphp（非:static-builder），执行RUN install-php-extensions pdo_mysql即可，它会自动编译并启用 NTS 版本 - 改用动态构建的 FrankenPHP：放弃
frankenphp_1.2.0_linux_amd64这类预编译静态包，改用dunglas/frankenphp:alpine或自己基于static-builder-gnu构建带--enable-pdo-mysql的定制版（注意：需确保链接的libmysqlclient在目标系统存在） - 接受内置驱动：FrankenPHP 静态版默认已 baked-in
pdo_sqlite，如果项目能临时切 SQLite 做开发验证，php -r "print_r(PDO::getAvailableDrivers());"会返回['sqlite']，说明 PDO 子系统本身是通的
最容易被忽略的 PDO 初始化陷阱
即使你成功让 pdo_mysql 出现在 frankenphp -m 列表里，也不代表 new PDO() 就一定能连上数据库。因为：
- 静态二进制若链接的是 musl libc（如 Alpine 镜像），而 MySQL 服务端要求 glibc 的
libresolv功能，PDO::__construct可能静默失败或超时 -
pdo_mysql.default_socket在 php.ini 中未设置，且 MySQL 不在 localhost:3306，连接会 fallback 到 TCP 但不报明确错误 - Laravel 的
DB_CONNECTION=mysql被识别，但DB_HOST指向容器名（如mysql），而 FrankenPHP 进程网络命名空间未与 Docker 网络对齐，gethostbyname返回空
上线前务必用最小脚本验证：frankenphp php-cli -r '$pdo = new PDO("mysql:host=mysql;dbname=test", "u", "p"); print "OK\n";' —— 不要依赖框架层的抽象，直击底层初始化。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
