Composer require predis/predis 报错主因有三：PHP版本不匹配（8.0+用^2.0，7.4需^1.1）、国内网络超时（应切阿里云镜像）、phpredis扩展干扰（建议禁用或统一驱动）。
composer require predis/predis 为什么报错？
常见错误不是命令本身写错了，而是环境卡在三个地方：PHP 版本不匹配、国内网络超时、已有 phpredis 扩展干扰。
- PHP 8.0+ 才能装
predis/predis:^2.0；若用 PHP 7.4，必须加版本约束：composer require predis/predis:^1.1 - 默认走
packagist.org，国内常卡住或 404，先切阿里云镜像：composer config -g repo.packagist composer <a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a> - 如果
php.ini已启用extension=redis.so，又在 Laravel 等框架里同时加载了 Predis，类名可能被覆盖——建议禁用原生扩展，或统一用一种驱动
连接 Redis 总是“成功但读不到数据”？
这不是连不上，是默认连了 db 0，而你写数据时用了别的库（比如 SELECT 1），或者 key 被其他客户端清空了。
- 连接时显式指定
database参数，避免依赖默认值：new Client(['host' => '127.0.0.1', 'port' => 6379, 'database' => 1]) - 验证数据是否存在，别只信代码逻辑：进
redis-cli手动执行SELECT 1，再跑KEYS *或DBSIZE - 注意 Laravel 等框架的
config/database.php里database值是否和你代码里一致，否则写进去、读出来根本不在一个库
高并发下 Predis 报 “Connection refused” 或响应慢？
Predis\Client 是无连接池的轻量客户端，每次 new 就建新 TCP 连接。在 Swoole、Hyperf 或长生命周期环境中，这会迅速打爆 Redis 连接数或耗尽本地端口。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 绝对不要在循环里反复
new Predis\Client()，应复用单例，或交由 DI 容器管理 - 在 Hyperf 中必须配
redis.pool，设好min_connections和max_connections；默认只建 1 个连接，扛不住并发 - 若用原生 PHP-FPM，可配合
connection_timeout和read_write_timeout参数防卡死：['scheme' => 'tcp', 'host' => '127.0.0.1', 'port' => 6379, 'connection_timeout' => 1.0, 'read_write_timeout' => 1.0]
require 'vendor/autoload.php' 后仍提示 Class not found？
说明自动加载没生效，最常见两种情况：文件路径不对，或 composer.json 没真正生成 vendor。
- 检查当前脚本所在目录是否真有
vendor/autoload.php；如果在子目录运行，要用相对路径如require <strong>DIR</strong>.'/../vendor/autoload.php'; - 运行
composer install（而非仅init）确保依赖已下载；ls vendor/predis应能看到完整目录结构 - Windows 下注意路径分隔符，但 Composer 自动处理，一般不用改；真正要小心的是 Apache/PHP 没读取到
vendor目录权限（尤其 WAMP/XAMPP）
Predis 的坑不在语法，而在它太“干净”——不依赖扩展、不自带连接池、不强制配置项。这意味着所有环境细节都得你亲手过一遍，少一个就静默失败。
