Laravel测试报错：Class 'App\Http\Requests\Api\BaseFormRequest'未找到

我之前也碰到过这种诡异的情况——API用Postman调用完全正常，但跑测试就报类找不到，而且composer dump-autoload也不管用。咱们一步步来排查解决：

1. 先盯紧PSR-4规范的大小写问题 #

Linux系统是区分大小写的，而Laravel的自动加载完全依赖PSR-4的严格匹配，这大概率是问题根源：

• 确认BaseFormRequest.php的实际路径是app/Http/Requests/Api/BaseFormRequest.php（重点看Api目录首字母是不是大写，文件名BaseFormRequest.php的大小写也要和类名完全一致）
• 检查StoreTeacherAttendanceRequest.php里的引用语句use App\Http\Requests\Api\BaseFormRequest;，命名空间的大小写必须和文件路径完全对应，哪怕一个字母大小写错了，Linux下都会找不到文件。

2. 清空所有测试相关的缓存 #

测试环境有时候会残留旧的类缓存，导致自动加载逻辑混乱，执行这些命令清干净：

# 清理Laravel常规缓存
php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

# 专门清理测试缓存
php artisan test --clear-cache

3. 重新生成优化后的自动加载文件 #

单纯的composer dump-autoload可能不够，试试带优化参数的命令，让Composer重新生成更精准的类映射：

composer dump-autoload -o

-o参数会生成优化后的类自动加载映射，比默认的动态扫描更可靠，尤其适合测试环境。

4. 检查PHPUnit配置文件 #

打开项目根目录的phpunit.xml，确认bootstrap属性指向的是正确的自动加载文件，确保测试时用的是项目本地的vendor/autoload.php，而不是系统全局的：

<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         ...>

5. 检查测试类的引用和命名空间 #

看看你的测试文件里是不是正确引用了StoreTeacherAttendanceRequest，有没有拼写错误，比如：

use App\Http\Requests\StoreTeacherAttendanceRequest;

同时测试类本身的命名空间要和tests/目录下的文件结构对应，比如Tests\Feature\Api\TeacherAttendanceTest的命名空间要对应tests/Feature/Api/TeacherAttendanceTest.php的路径。

6. 修复文件权限（Linux系统） #

重装系统后，项目文件的权限可能出现问题，导致Composer无法正确读取或生成自动加载文件，执行以下命令修复：

chmod -R 755 app/ vendor/
chown -R your-username:your-group ./

把your-username和your-group换成你当前的系统用户和组（比如ropali:ropali）。

如果以上步骤都试过还是不行，那就彻底重来：删除vendor目录和composer.lock文件，然后执行composer install重新安装所有依赖，这样能彻底重置自动加载逻辑。

内容的提问来源于stack exchange，提问作者Ropali Munshi