为何PHPStan无法识别configDebug方法的默认参数？

问题重现 #

PHPStan检测到报错：

Line base\Kader\Kader.php (in context of class Kader\Debugging)

---

107 Method Kader\Debugging::configDebug() invoked with 0 parameters, 2 required.

---

[ERROR] Found 1 error

调用代码为：$this->configDebug();，对应方法定义是：public function configDebug($action = 'start', $options = []) {}，明明参数带有默认值，却被PHPStan判定需要传入2个参数。

可能的原因及解决办法 #

• 子类重写方法未保留默认参数：如果调用代码所在的Kader类继承了Debugging类，且在Kader中重写了configDebug方法，需确保重写时也声明默认参数。比如重写方法若写成public function configDebug($action, $options) {}，即使父类有默认值，PHPStan也会认为需要传入2个参数。
• $this类型推断错误：PHPStan可能将调用位置的$this推断为其他类型，而非Debugging或其子类。可在调用代码上方添加类型注释强制指定：

  /** @var Kader\Debugging $this */
  $this->configDebug();
  

• PHPStan缓存过期：旧缓存可能保留了方法的旧定义（比如之前无默认参数的版本）。执行phpstan clear-cache命令清除缓存后，重新运行分析。
• 类加载或命名空间问题：确认Kader\Debugging类的命名空间正确，且PHPStan能通过自动加载器找到该类的完整定义。若类文件未被正确加载，PHPStan无法识别默认参数。
• PHPStan配置异常：检查phpstan.neon配置文件，是否存在禁用默认参数识别的规则，或分析级别设置过高导致误判（默认级别通常支持默认参数识别）。

内容的提问来源于stack exchange，提问作者Graham Reynolds