session_start() 报错“Failed to initialize storage module”的根本原因是 session.save_path 目录不可写、不存在或属主不匹配；需检查路径存在性、权限（推荐755/700）、属主（如www-data:www-data），并确保PHP-FPM用户与Web服务器一致，SELinux上下文正确，且调用session_save_path()须在session_start()前。
session_start() 报错：Failed to initialize storage module
这是 php 会话启动失败最典型的错误，根本原因不是代码写错了，而是 session.save_path 指向的目录不可写，或该目录不存在、属主不匹配。php 默认用系统临时目录（如 /tmp），但在多用户环境（比如 cpanel、plesk 或自建 lamp）里，这个路径常被限制或清理过。
- 先确认当前配置：
ini_get('session.save_path')，别只信 php.ini 里的注释值 - 检查该路径是否存在：
ls -ld /var/lib/php/sessions（常见路径，具体以phpinfo()输出为准） - 重点看权限和属主：
www-data:www-data（Debian/Ubuntu）或apache:apache（CentOS/RHEL）必须对目录有读写执行权限 - 不要用
777—— 安全策略会拦截，755或700配合正确属主才可靠
手动设置 session.save_path 的安全写法
硬编码路径容易出错，尤其在不同服务器环境间迁移时。推荐在脚本开头用 session_save_path() 动态指定，并配合 is_writable() 校验。
- 优先选项目私有目录：
session_save_path(__DIR__ . '/runtime/sessions') - 创建前务必检查：
if (!is_writable($path)) { mkdir($path, 0700, true); chown($path, 'www-data'); } - 避免在
session_start()后调用session_save_path()—— 会直接报 Warning 并失效 - Apache + mod_php 下，
session.save_path在.htaccess中设无效，必须用php_value或 ini_set
PHP-FPM 场景下 session 目录权限更难搞？
PHP-FPM 进程通常以非 root 用户运行（如 www-data），但它的 user 和 group 配置可能和 Nginx/Apache 不一致，导致会话目录“看起来可写，实际写不了”。
- 查 FPM 用户：
ps aux | grep php-fpm，看 master 进程的 USER 列 - 对比 Nginx 用户：
ps aux | grep nginx，确认是否同为www-data - FPM pool 配置里若设了
clear_env = no，环境变量可能污染 session 路径，建议显式设env[SESSION_SAVE_PATH] = /path/to/sessions - SELinux 启用时，
ls -Z /var/lib/php/sessions可能显示 context 不匹配，需用semanage fcontext -a -t httpd_var_run_t "/path/to/sessions(/.*)?"修复
session_start() 返回 false 却没报错？开启错误报告
默认配置下，session_start() 失败只返回 false，不抛异常也不输出错误，极易被忽略。尤其在 AJAX 请求或 CLI 脚本中，静默失败最难排查。
- 开发阶段强制报错：
ini_set('display_errors', '1'); error_reporting(E_ALL); - 检查返回值：
if (session_start() === false) { error_log('Session init failed: ' . session_status()); } -
session_status()返回PHP_SESSION_NONE表示完全未启动，PHP_SESSION_DISABLED表示扩展被禁用（少见但可能） - 注意：某些 CDN 或反向代理（如 Cloudflare）会过滤 Set-Cookie 响应头，导致客户端收不到 session_id，这不是 PHP 层问题，但现象类似
真正麻烦的不是找不到路径，而是多个服务组件（PHP-FPM、Web 服务器、SELinux、容器卷挂载）在权限链上各走一步，最后卡在某个你没检查的环节。每次改完权限，记得重启 PHP-FPM，而不是只 reload Nginx。
立即学习“PHP免费学习笔记（深入）”；
