PhpStorm检测报错：try块未抛出异常但父类方法实际会抛出

我懂这种被IDE静态分析误报烦到的感觉！你遇到的问题本质是PhpStorm的代码检查没正确追踪到：父类方法抛出的自定义异常，会通过子类的方法调用传递到上层调用代码中。下面给你几个亲测有效的解决办法：

1. 给子类方法添加@throws PHPDoc注释 #

PhpStorm严重依赖PHPDoc注释来做静态代码分析，哪怕子类方法本身没有直接抛出异常，只要它调用了会抛异常的父类方法，给子类方法加上对应的@throws注释，就能让IDE识别到异常会传递出去。示例代码如下：

class ParentClass {
    /**
     * @throws YourCustomException
     */
    public function parentMethod() {
        throw new YourCustomException("业务异常提示");
    }
}

class ChildClass extends ParentClass {
    /**
     * 明确标注这个方法会抛出父类传递来的自定义异常
     * @throws YourCustomException
     */
    public function childMethod() {
        // 调用父类抛异常的方法，子类不捕获，交给上层处理
        $this->parentMethod();
    }
}

// 上层调用代码
try {
    $child = new ChildClass();
    $child->childMethod();
} catch (YourCustomException $e) {
    // 处理异常
}

添加注释后，PhpStorm就会识别到childMethod()确实可能抛出YourCustomException，不会再提示“捕获的异常未在try块中抛出”。

2. 调整PhpStorm的异常检查级别 #

如果你不想给每个子类方法加注释，可以降低这个检查的严格程度：

• 打开PhpStorm设置（快捷键Ctrl+Alt+S，Mac是Cmd+,）
• 依次导航到Editor > Inspections > PHP > Error handling > Unhandled exception
• 将检查级别从默认的“Error”改为“Warning”，或者根据需求选择“Info”；如果完全不想看到这个提示，也可以直接禁用该检查。

不过更推荐改成警告级别，既不会误报干扰开发，又能保留对真正未处理异常的提示。

3. 确认父类方法的@throws注释完整 #

有时候父类方法本身没正确标注@throws，也会导致PhpStorm无法追踪异常传递链。先检查父类方法的PHPDoc，确保它明确标注了抛出的自定义异常类，这样子类调用时，IDE才能正确识别异常来源。

内容的提问来源于stack exchange，提问作者Rick Kukiela