因为 Stash 未在 composer.json 中声明 PSR-4 自动加载映射，导致 new Pool() 时类找不到；需手动添加 "Stash\\": "vendor/tedivm/stash/src/" 到 autoload 或用全限定名。
直接用 composer require tedivm/stash 就能装上 Stash，但光装完不行——它不自动注册自动加载规则，也不自带开箱即用的缓存池配置，得手动补全初始化逻辑，否则 new Pool() 会报类找不到。
为什么 composer require tedivm/stash 后还不能直接 new Pool？
Stash 的 autoloading 是按 PSR-4 规则注册的，但它的主命名空间 Stash 没有在 composer.json 的 autoload 字段里声明映射路径。Composer 只加载 vendor 里的包，但不会主动把 Stash* 映射到 vendor/tedivm/stash/src/ —— 这个映射得你自己加，或者改用 use 全限定名绕过 autoload 问题。
常见错误现象：Class 'StashPool' not found 或 Attempted to load class "Pool" from namespace "Stash"
- 检查
vendor/tedivm/stash/src/是否存在，确认安装成功 - 运行
composer dump-autoload -o强制重建优化 autoload map - 如果仍失败，在
composer.json的autoload下手动加一段（推荐）："psr-4": {"Stash\": "vendor/tedivm/stash/src/"} - 改用全限定名写法可临时跳过 autoload 问题：
$pool = new StashPool(...)
StashDriverFileSystem 初始化时路径权限和结构容易出错
FileSystem 驱动依赖真实目录写入，但默认不自动创建父级路径，且对 umask 敏感。Windows 和 Linux 下行为不一致，尤其当项目部署在 Docker 或共享主机时，mkdir 失败往往静默吞掉异常，导致后续 save() 返回 false 却无提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 务必提前确保目标路径可写：
chmod -R 777 ./cache/stash（开发环境），生产环境建议用www-data所属用户 - 初始化前手动创建目录并验证：
if (!is_writable('./cache/stash')) { throw new RuntimeException('Stash cache dir not writable'); } - 避免使用相对路径如
./cache，改用绝对路径：__DIR__ . '/cache/stash' - Driver 构造参数支持
path和filePermissions，后者默认是0600，在多进程环境下可能引发读写冲突，建议设为0666
缓存命中判断必须用 $item->isMiss()，不能靠 === false
Stash 的 $item->get() 在缓存未命中、过期、或值本身为 false/null/0 时都返回 null，不是 false。直接判空会导致误删有效缓存或重复查库。
典型错误写法：
if (!$item->get()) { /* 错！0 和 false 都进这里 */ }
- 正确做法永远只用
$item->isMiss()判断是否需要回源 -
$item->get()返回的是原始存入的值，类型完全保留，包括false、0、'' - 设置过期时间用秒数（int），不是
DateInterval，别跟 Doctrine Cache 混淆 - 调用
$pool->clear()清空全部缓存时，注意它不返回布尔值，而是 void，别拿它做 if 判断
Stash 的 Driver 层抽象很干净，但初始化链路比 Doctrine Cache 更“裸”——没默认目录、没自动 mkdir、没 fallback 机制。真正用起来，new Pool(new FileSystem($path)) 这一行代码背后藏着至少三个要手敲的防御性检查：路径存在、可写、autoload 正确。漏掉任何一个，都会让缓存静默失效，而不是抛错提醒你。
