PHP Stan 0级分析遇类未找到错误，求排查方案

安全阿岳

2026-7-12

排查PHPStan "Class object was not found" 报错的额外方向

针对你遇到的两个文件独有的报错，除了常规的文件、命名空间检查，还可以从这些方向排查：

文件名大小写不匹配：如果开发环境是Windows（大小写不敏感）但PHPStan运行在Linux环境下，类名和文件名的大小写不一致会导致识别失败。比如类是Results但文件名是results.class.php，仔细核对两者的大小写。
文件含特殊字符或编码问题：检查这两个文件是否有不可见的特殊字符（比如UTF-8 BOM），或者编码异常导致PHPStan解析类定义失败。可以用编辑器开启"显示所有字符"功能，或者用cat -A命令查看文件内容。
PHPStan配置的扫描规则：打开phpstan.neon（或phpstan.neon.dist），确认这两个文件没有被excludePaths规则排除，同时检查autoload配置是否正确覆盖了它们的命名空间，有没有遗漏的映射规则。
类定义的语法/结构问题：这两个类是否存在隐性语法错误？比如未闭合的括号、引号，或者使用了PHPStan 0级规则下仍未兼容的特殊语法（比如某些罕见的trait用法、复杂继承链）。即使PHP运行时不报错，PHPStan的静态解析可能卡在这里。
依赖类未被识别：如果这两个类引用了其他未被PHPStan扫描到的类（比如某个扩展的类、未加入自动加载的自定义类），也会触发这个报错。检查类内部的use语句和依赖。
清除PHPStan缓存：PHPStan会缓存分析结果，缓存损坏可能导致异常。删除默认缓存目录var/cache/phpstan，然后重新运行分析命令。