必须先验证php扩展兼容性、$_server变量行为及worker模式下框架生命周期稳定性，否则易致500错误或静默失败；frankenphp需用frankenphp -m查扩展、确认extension_dir路径、重编译c扩展，并重点校验$_server关键字段与框架单例复用性。
必须先验证 PHP 扩展兼容性、$_SERVER 变量行为、worker 模式下框架生命周期是否稳定，否则上线后大概率出现 500 或静默失败。
PHP 扩展是否被 FrankenPHP 正确加载
FrankenPHP 不走传统 php.ini 的扩展加载路径，而是通过内置机制按需启用。很多扩展（尤其是 C 扩展）依赖 Zend 引擎的特定初始化时机，而 FrankenPHP 的 PHP 运行时嵌入在 Go 进程中，初始化顺序和内存模型不同。
- 运行
frankenphp -m查看已启用模块列表，确认opcache、pdo_mysql、curl等关键扩展在列（注意：apcu默认不支持，redis需用php8.2-franken-redis包） - 检查
extension_dir路径是否指向 FrankenPHP 自带的扩展目录（通常是/usr/lib/php/8.2/franken），而非系统 PHP 的/usr/lib/php/8.2 - 自定义 C 扩展必须用 FrankenPHP 提供的
frankenphp-build工具重新编译，直接复制.so文件会报undefined symbol: zend_object_std_init
$_SERVER 和请求上下文是否与 Nginx+PHP-FPM 一致
FrankenPHP 的 HTTP 层由 Caddy 驱动，不是 FastCGI 协议转发，所以 $_SERVER 中大量字段值会变。Laravel、Symfony 等框架依赖这些字段做路由解析、URL 生成、HTTPS 判断，错一个就可能跳转到 http:// 或生成错误重定向。
- 重点验证：
$_SERVER['REQUEST_URI']（是否含 query string）、$_SERVER['HTTPS']（是否为on）、$_SERVER['HTTP_X_FORWARDED_PROTO']（Caddy 默认不设，需显式配置）、$_SERVER['SCRIPT_NAME']（FrankenPHP 默认设为/index.php，Nginx 常设为空） - 在测试环境加一段调试代码：
var_dump(array_intersect_key($_SERVER, array_flip(['REQUEST_URI', 'HTTPS', 'HTTP_X_FORWARDED_PROTO', 'SCRIPT_NAME', 'SERVER_PORT']))); - 若用 Laravel，务必跑一遍
php artisan tinker并执行url('/')和request()->fullUrl()，确认协议和 host 正确
Worker 模式下框架单例和服务容器是否真正复用
开启 worker 后，PHP 进程常驻，但框架是否真的“只初始化一次”，得实测。很多项目在 bootstrap/app.php 或服务提供者里写了全局状态（如静态变量缓存、未清空的单例连接池），在 worker 模式下会跨请求污染。
- 在 Laravel 中，写个接口返回
app()->isBooted()和spl_object_id(app('log'))，连续调用 10 次，观察 ID 是否始终不变 - 检查数据库连接：执行
DB::connection()->getPdo()，对比两次请求的spl_object_id，若变化说明连接被重建，max_requests可能被误触发或连接未正确复用 - 禁用 opcache file cache（
opcache.file_cache=留空），否则某些框架的 config 缓存会因文件修改时间判断失效，导致 worker 重启后读旧配置
最容易被忽略的是日志和异常处理的线程安全性——FrankenPHP 多线程并发处理请求，但很多老项目日志类是单例且内部用 fopen(..., 'a')，多个线程同时写一个文件会导致内容错乱甚至丢行。测试时别只看 HTTP 状态码，一定要翻 storage/logs 里的实际内容是否完整连贯。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
