thinkphp8分布式需显式配置database.php中deploy和rw_separate均为1、hostname为数组、master_num指定多主、read_consistent开启；redis session须设expire且host/port/password齐全；多应用需隔离cache prefix。
ThinkPHP 原生支持分布式，但直接开箱即用会踩坑——关键不在“能不能做”，而在“哪些配置项必须显式声明”和“哪些行为会被隐式覆盖”。
database.php 中 deploy 和 rw_separate 必须同时设为 1
只设 'deploy' => 1 不会触发读写分离；只设 'rw_separate' => true 但 deploy 是 0，框架会忽略该参数。两者是开关组合，缺一不可。
-
hostname必须是数组（如['db-master', 'db-slave1', 'db-slave2']），字符串逗号分隔在 TP8 已被弃用，会导致从库连接失败 - 主库默认取数组第一个元素，但若需多主写入，必须显式加
'master_num' => 2，否则即使写了两个地址，也只用第一个 -
read_consistent设为true可缓解主从延迟导致的读不到刚写数据的问题，但会轻微增加主库查询压力
Redis 分布式 Session 的 expire 和 PHP ini 冲突问题
TP8 的 Redis Session 驱动完全绕过 PHP 原生的 session.gc_maxlifetime，只认 config/session.php 里的 expire 字段。设错就会出现“登录两小时自动掉线”，而你调大了 php.ini 却毫无作用。
- 确认
config/session.php中'type' => 'redis'后，'expire'必须显式设置（单位：秒），例如'expire' => 7200 -
'host'、'port'、'password'缺一不可；密码为空时也要写''，不能删掉该键 - 云 Redis 实例常默认关闭
timeout，需手动在 redis.conf 中设timeout 300，否则长连接空闲后被服务端断开，TP8 不重连，Session 写入静默失败
多应用模式下缓存前缀不隔离导致 key 冲突
admin、api、web 三个应用共用同一套 Redis 实例时，若没区分缓存前缀，Cache::tag('user')->get('1001') 在 admin 和 api 里可能命中彼此的数据，尤其是 tag 缓存共享同一命名空间。
- 每个应用的
config/cache.php应单独配置'prefix' => env('APP_NAME', 'common') . ':' - 不要依赖全局
cache.php的 prefix，多应用下它会被各子配置覆盖，但中间件或命令行调用时容易误用默认值 - 使用
Cache::store('redis-admin')显式指定 store，比靠环境变量更可控；store 名需在config/cache.php的stores数组中明确定义
真正难的不是配通，而是所有分布式组件（DB、Cache、Session）的超时时间、重试策略、失败降级逻辑必须对齐——比如数据库连接超时设 3 秒，而 Redis Session 写入超时设 1 秒，就可能在 DB 慢查时 Session 已经丢弃，用户看到的是“登录成功但立刻登出”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
