FrankenPHP会话丢失本质是运行模型变更导致配置未对齐，需从会话启动时机、存储路径权限、Cookie属性适配、跨域凭据传递四方面显式控制：确保每个脚本顶部无条件调用session_start()；显式设置可写session.save_path；用session_set_cookie_params统一配置secure/httponly/SameSite；跨域时前后端协同启用credentials与CORS头；推荐改用Redis存储避免文件系统问题。
FrankenPHP 部署后出现会话丢失，本质不是 FrankenPHP 自身的缺陷，而是它改变了传统 PHP-FPM 的运行模型（基于 SAPI 的长生命周期进程），导致原有 Session 配置在新环境下“失效”或“未对齐”。常见表现是：登录后跳转即登出、$_SESSION 为空、多次刷新生成新 PHPSESSID。核心问题集中在 会话启动时机、存储路径权限、Cookie 属性适配、跨域凭据传递 四个层面。
会话未在每个请求开头正确启动
FrankenPHP 默认以 HTTP/2 和协程方式处理请求，不自动触发传统 CGI/FPM 的 session 初始化流程。若代码中仅在部分文件（如 login.php）调用 session_start()，而其他页面（如 dashboard.php、api.php）遗漏或放在输出之后，会话就无法延续。
- 确保所有需会话的 PHP 脚本顶部第一行（无空格、无 BOM、无 echo、无 HTML）执行：
<?php session_start(); ?> - 禁用
session.auto_start = Off（FrankenPHP 不支持该配置，启用会导致不可预知行为） - 避免封装在条件判断里，例如不要写
if (is_logged_in()) { session_start(); }
Session 存储路径不可写或被隔离
FrankenPHP 运行于自己的进程上下文（常为非 www-data 用户，如 frankenphp 或容器内 UID），默认 session.save_path（如 /tmp 或 /var/lib/php/sessions）可能无写权限，或被容器/沙箱限制访问。
- 在脚本中加一行检查：
echo 'Save path: ' . session_save_path() . '; Writable? ' . (is_writable(session_save_path()) ? 'Yes' : 'No'); - 显式设置可写路径（推荐绝对路径）：
ini_set('session.save_path', '/app/runtime/sessions');
并确保该目录存在且权限开放：mkdir -p /app/runtime/sessions && chmod 770 /app/runtime/sessions && chown frankenphp:frankenphp /app/runtime/sessions - 若用 Docker，挂载宿主机目录时确认 UID/GID 匹配，或改用
--user指定一致用户
Cookie 域、安全标志与 FrankenPHP 的 HTTPS 上下文不匹配
FrankenPHP 常部署在反向代理（如 Caddy/Nginx）后，实际是 HTTPS 入口，但 PHP 内部可能感知为 HTTP，导致 session.cookie_secure = 1 生效后浏览器拒绝保存 Cookie。
立即学习“PHP免费学习笔记（深入）”；
- 在
session_start()前统一设置 Cookie 参数：session_set_cookie_params([<br> 'lifetime' => 86400,<br> 'path' => '/',<br> 'domain' => '.yourdomain.com', // 跨子域用点前缀；本地开发留空<br> 'secure' => isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on'<br> || (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https'),<br> 'httponly' => true,<br> 'samesite' => 'Lax'<br>]);
- 务必关闭
session.use_strict_mode = 0（FrankenPHP + PHP 8.4 下 strict mode 易误拒合法 ID） - 开发时避免设
domain='.localhost'—— 浏览器不认，应设为空字符串''
前后端分离场景下跨域凭据未透传
若前端（如 Vue/React）部署在 https://app.example.com，后端 API 由 FrankenPHP 托管在 https://api.example.com，则属于跨域。此时 Cookie 默认不发送，必须前后端协同配置。
- 前端 fetch 请求必须带：
credentials: 'include' - 后端响应头必须含：
header('Access-Control-Allow-Credentials: true');<br>header('Access-Control-Allow-Origin: https://app.example.com');
（注意：不能用*） - 上述 header 必须在
session_start()之前、任何输出之前输出 - 强烈建议改用 Redis 存储会话，避免文件系统单点和多实例不一致：
ini_set('session.save_handler', 'redis');<br>ini_set('session.save_path', 'tcp://redis:6379');
FrankenPHP 的会话问题，多数源于从 FPM 迁移时沿用了旧配置却忽略了运行时环境差异。重点不在“修 Bug”，而在“对齐上下文”——把 session 启动、存储、传输、清理四个环节全部显式控制住，而不是依赖隐式行为。
