Laravel8 Route::resource使用控制器类名时命名空间重复报错

问题现象 #

Laravel 8项目运行时抛出控制器不存在异常，报错信息显示控制器命名空间被重复拼接两次：

Target class [App\Http\Controllers\App\Http\Controllers\customerController] does not exist.

报错的直接诱因是App\Http\Controllers命名空间在路由解析阶段被重复加载。

异常触发时的相关配置 #

• app/Providers/RouteServiceProvider.php中手动添加了全局命名空间配置：

  protected $namespace = 'App\\Http\\Controllers';
  

• routes/web.php中采用类名引用方式配置资源路由：

  use App\Http\Controllers\customerController;
  use Illuminate\Support\Facades\Route;
  use Illuminate\Support\Facades\Auth;
  
  Route::resource("customers", customerController::class);
  

临时规避方案 #

改用Laravel旧版本兼容的字符串语法配置路由，异常会消失，路由可正常解析：

Route::resource("customers", "customerController");

根本原因 #

Laravel 8版本默认取消了RouteServiceProvider中全局预设控制器命名空间的设计，原生支持直接通过类名::class的方式引用控制器配置路由——这种写法传入的是包含完整命名空间的控制器类路径，框架不会额外拼接命名空间前缀。
如果手动给RouteServiceProvider添加$namespace = 'App\\Http\\Controllers'配置，框架解析路由时会给所有传入的控制器路径强制拼接该前缀：

• 使用类名引用写法时，传入的customerController::class本身已经携带完整的App\Http\Controllers命名空间，再被强制拼接一次前缀后，就会生成带双重复命名空间的错误类路径，触发类不存在异常
• 使用字符串语法配置控制器时，传入的只有不带命名空间的类名字符串，拼接预设前缀后刚好是正确的完整类路径，因此可以正常运行

修复方案 #

两种方案二选一即可，不要混用两套路由配置逻辑，避免出现解析冲突：

• 若偏好使用类名::class的现代路由写法：直接删除RouteServiceProvider中手动添加的$namespace属性配置
• 若偏好沿用Laravel旧版本的字符串传参习惯：保留$namespace配置，所有路由统一使用字符串格式传入控制器名，不要和类名引用写法混用

内容的提问来源于stack exchange，提问作者Muhammad Hassan Javed