Session start error 根本原因是 PHP 的 session.save_path 目录不可写或未配置，ThinkPHP 默认使用原生 session 机制，其配置项不生效；需通过 php.ini、ini_set() 等方式设置且确保 Web 进程用户有读写权限。
Session start error 是因为 session.save_path 不可写或未配置
ThinkPHP 启动 Session 失败，90% 是因为底层 PHP 的 session_start() 调用失败，而根本原因集中在 session.save_path 指向的目录不可写，或者压根没设（用了 PHP 默认值，但默认路径往往权限受限）。
ThinkPHP 本身不接管 session 文件写入逻辑，它只是调用 PHP 原生函数；所以问题不在框架配置项里，而在 PHP 运行时环境。常见错误现象是：Warning: session_start(): Failed to initialize storage module 或更直白的 Permission denied。
- 检查当前生效的
session.save_path：在控制器里临时加var_dump(ini_get('session.save_path'));，别只看php.ini，CLI 和 FPM 可能加载不同配置 - 确保该路径存在且 Web 进程用户（如
www-data、nginx或apache）有读写权限，不是仅chmod 755就完事——必须是775或777（开发环境），且属主/属组正确 - 避免用系统级路径如
/var/lib/php/sessions，尤其在 Docker 或共享主机中，优先改到项目内可控目录，比如runtime/session
ThinkPHP 的 session 配置项不等于 PHP 的 session.save_path
很多人在 config/session.php 里改了 'type' => 'file' 和 'path' => './runtime/session'，就以为万事大吉——其实这只是 ThinkPHP 自己的会话驱动抽象层配置，对原生 session_start() 完全无效。只有当 'type' => 'native'（默认值）时，框架才直接调用 PHP 原生 session，此时真正起作用的是 PHP 的 session.save_path ini 设置。
-
'type' => 'file'是 ThinkPHP 自研文件驱动，绕过 PHP 原生 session，此时session.save_path完全无关，但你要自己保证'path'可写，且注意并发写入风险（无锁） -
'type' => 'native'（默认）才是走 PHP 原生流程，必须通过ini_set('session.save_path', ...)或修改php.ini/.htaccess/php-fpm.conf来生效 - 验证方式：在入口文件
public/index.php最开头加ini_set('session.save_path', __DIR__.'/../runtime/session');，比改配置文件更直接可靠
Docker 或宝塔环境下 session.save_path 权限容易被覆盖
容器启动或面板重启 PHP 服务时，常会重置 session.save_path 到系统默认值，或挂载卷后目录属主变成 root，导致 Web 进程无法写入。这不是 ThinkPHP 的锅，但表现就是「昨天还好，今天突然报错」。
立即学习“PHP免费学习笔记（深入）”；
- Docker 中，在
Dockerfile或entrypoint.sh里显式设置：RUN mkdir -p /var/www/runtime/session && chown -R www-data:www-data /var/www/runtime - 宝塔用户别只信面板里的「PHP 设置」页，去查
/www/server/php/{版本}/etc/php.ini确认session.save_path行是否被注释，以及路径是否存在 - Linux 下用
ps aux | grep php看进程运行用户，再用ls -ld /path/to/session核对属主和权限，两者不一致必挂
Windows + Apache 本地开发时 session.save_path 路径斜杠写法要小心
Windows 下如果 session.save_path 写成 C:\temp\session，PHP 有时会因反斜杠转义出问题；而写成 C:/temp/session 或 C://temp//session 更稳妥。这不是 ThinkPHP 特有，但本地调试时容易卡在这一步。
- 推荐统一用正斜杠：
ini_set('session.save_path', 'C:/www/myapp/runtime/session'); - 确保路径中没有中文、空格或特殊符号，哪怕目录名是
session_测试也可能触发奇怪的failed to open stream - Apache 的
httpd.conf里如果启用了mpm_winnt模块，session 目录权限检查逻辑和 Linux 不同，优先试runtime/session这种相对路径
真正麻烦的从来不是“怎么配”，而是多个配置层级（PHP ini、Web 服务器、容器、ThinkPHP config）之间互相遮蔽，加上权限属主这种看不见的依赖。盯住 session_start() 报错前那一行 ini_get('session.save_path') 输出，比翻十遍文档都管用。
