ReturnTypeWillChange警告是PHP 8.1引入的弃用提示，因实现Iterator等接口时未声明返回类型所致，需为current()、key()等方法显式添加如: mixed等返回类型声明。
为什么 PHP 8.1+ 里总冒出 ReturnTypeWillChange 警告？
这是 PHP 8.1 引入的「弃用警告」，不是错误，但说明你用的某个包在实现 Iterator、ArrayAccess 等接口时，没显式声明返回类型——而 PHP 8.1 要求这些方法必须加返回类型声明（比如 public function current(): mixed），否则就报这个提示。
常见于老旧的 ORM、缓存、测试工具等依赖，比如 doctrine/collections 旧版、phpunit/phpunit 9.x 或某些自定义迭代器类。
composer update 时如何定位具体是哪个包触发的？
别靠猜。直接让 Composer 显示完整依赖树并过滤关键词：
composer show --tree | grep -A5 -B5 "ReturnTypeWillChange"
更稳妥的做法是临时启用 PHP 的弃用报告，运行一次触发警告的脚本（比如 php -d error_reporting=E_ALL index.php），看堆栈里第一个非你代码的文件路径，再用 composer show -i vendor/name 查它属于哪个包。
立即学习“PHP免费学习笔记（深入）”；
-
composer show vendor/name看当前安装版本 - 去该包的 GitHub Releases 页面查是否已修复（搜索关键词
ReturnTypeWillChange或PHP 8.1） - 注意：有些包在 v2.x 修复了，但你的
composer.json锁死在 v1.x，composer update不会自动跨主版本升级
升级失败或无法升级时的临时绕过方案
生产环境不建议长期关闭弃用警告，但开发/过渡期可临时压制，避免 CI 卡住或日志刷屏：
- 在入口文件顶部加：
error_reporting(E_ALL ^ E_DEPRECATED); - 或在
php.ini中设：error_reporting = E_ALL & ~E_DEPRECATED - PHPUnit 测试中可在
phpunit.xml里加：<php><ini name="error_reporting" value="32767"/></php>（32767 是E_ALL值，需手动减去E_DEPRECATED的 8192 → 实际填 24575）
⚠️ 注意：ReturnTypeWillChange 是「未来会变成致命错误」的信号。PHP 9.0 很可能直接报 Fatal error，现在压着不解决，等于攒技术债。
自己写包或改第三方包时怎么彻底修复？
核心就一条：所有实现接口中声明了返回类型的函数，你重写时必须带上对应返回类型（哪怕用 mixed）。
例如修复一个老迭代器：
class MyIterator implements Iterator
{
// ❌ PHP 8.1 警告
public function current()
{
return $this->data[$this->position];
}
<pre class='brush:php;toolbar:false;'>// ✅ 正确写法（PHP 8.1+ 兼容）
public function current(): mixed
{
return $this->data[$this->position];
}
// 同理，key()、next()、rewind()、valid() 都要补上返回类型
public function key(): mixed { /* ... */ }
public function next(): void { /* ... */ }
public function rewind(): void { /* ... */ }
public function valid(): bool { /* ... */ }}
如果目标 PHP 版本要兼容 7.4+，可用 mixed（PHP 8.0+）或退而求其次用 object/array 等具体类型——但别留空，也别用 @return void 这类 PHPDoc 代替真实声明。
真正麻烦的往往不是改一行类型，而是某个包修好了，它依赖的另一个包又爆了——这种链式兼容问题，得一层层顺藤摸瓜，没法一劳永逸。
