根本原因是FrankenPHP默认启用fastcgi_finish_request()，导致wp_set_auth_cookie()发出的Set-Cookie响应头被提前截断；浏览器收不到有效Cookie，登录态无法建立。
根本原因不是FrankenPHP本身，而是它默认启用的 fastcgi_finish_request() 机制与 WordPress 的 Cookie 设置时机冲突。
为什么 wp_set_auth_cookie() 会失效
WordPress 在登录成功后调用 wp_set_auth_cookie()，该函数依赖 PHP 的 setcookie() 发送 Set-Cookie 响应头。但 FrankenPHP 默认在 FastCGI 请求处理中途就调用 fastcgi_finish_request() —— 此时 PHP 脚本逻辑可能还没执行完，而 Web 服务器（如 Caddy）已提前关闭连接或丢弃后续响应头。
结果就是：浏览器收不到 Set-Cookie，或者只收到过期/空值 Cookie（比如 Expires=Thu, 01 Jan 1970 00:00:00 GMT），导致登录态无法建立。
常见现象包括：
立即学习“PHP免费学习笔记（深入）”；
- 登录页反复跳回
/wp-login.php?redirect_to=... - 开发者工具 Network 面板中，
wp-login.php响应头里有Location，但没Set-Cookie或Set-Cookie的Expires是过去时间 - 同一站点在 Apache/Nginx + PHP-FPM 下正常，换 FrankenPHP 后立即出问题
如何确认是 FrankenPHP 的 fastcgi_finish_request 干扰
在 FrankenPHP 的配置中（通常是 Caddyfile 或 frankenphp.yaml），检查是否启用了自动缓冲优化。Caddy 的 php_fastcgi 指令默认开启 fastcgi_finish_request，且无显式开关。
验证方式：
- 临时改用纯 PHP CLI 模式启动 FrankenPHP（绕过 Caddy）：
frankenphp run --workers=1 --document-root .，如果此时登录正常 → 基本锁定是 Caddy 层的 FastCGI 行为问题 - 在
wp-login.php结尾加一行：error_log("COOKIE SENT: " . print_r(headers_list(), true), 4);，查看日志是否真有Set-Cookie输出 —— 若日志里有、但浏览器没收到，就是响应被截断
绕过 fastcgi_finish_request 的实操方案
目前最稳定的做法是**禁用 FrankenPHP 的自动 finish 请求行为**，强制等待脚本完全结束再发响应：
- 如果你用 Caddy，修改
Caddyfile中的php_fastcgi块，在末尾添加：env FRANKENPHP_SKIP_FINISH_REQUEST=1 - 如果你用 Docker，启动时注入环境变量：
-e FRANKENPHP_SKIP_FINISH_REQUEST=1 - 如果你用 systemd 服务，编辑
.service文件，在Environment=行加入该变量
这个变量会让 FrankenPHP 跳过 fastcgi_finish_request() 调用，保证所有 setcookie() 在响应真正发出前完成。实测对 WordPress 登录、登出、后台 Ajax 请求全部生效。
⚠️ 注意：此举会略微增加首字节时间（TTFB），但对 WordPress 这类 I/O 密集型应用影响极小；若你依赖 fastcgi_finish_request 做异步日志或邮件发送，请改用 register_shutdown_function() 替代。
其他容易被忽略的协同配置点
即使关了 fastcgi_finish_request，以下三点仍可能让登录态“看似正常实则脆弱”：
-
session.cookie_secure和session.cookie_httponly必须与你的 HTTPS 实际状态一致 —— FrankenPHP 不自动推导，需在php.ini或frankenphp.yaml中显式设为On（HTTPS 站点）或Off（本地 HTTP） - WordPress 的
COOKIE_DOMAIN定义必须匹配当前 Host —— 推荐在wp-config.php中写：define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST'] ?? '');，避免硬编码导致子域名或端口不匹配 - Caddy 的
encode zstd gzip指令若开启，可能干扰含 Cookie 的小响应 —— 可临时注释掉 encode 块测试是否缓解
这些配置项单独看都合理，但组合起来会在 FrankenPHP 环境下形成“静默失败”链：Cookie 写入了，但因 Domain 不匹配被浏览器丢弃；或 Secure 标志错置导致 HTTPS 下不发送。
