Laravel控制器未检测到：本地正常但Ubuntu服务器报错排查

本地php artisan route:list报错「Class 'CuboController' does not exist」 #

• 核对命名空间与路由引用：Laravel 8+ 默认不再自动导入控制器命名空间，确保CuboController.php顶部有正确的命名空间namespace App\Http\Controllers;，路由文件中需使用完整类名（如App\Http\Controllers\CuboController::class），或提前通过use App\Http\Controllers\CuboController;导入。
• 检查文件名与类名一致性：Linux环境下文件名区分大小写，确认控制器文件名为CuboController.php，类定义为class CuboController extends Controller，避免大小写不匹配导致的类找不到问题。
• 刷新自动加载缓存：执行composer dump-autoload，重新生成类自动加载映射，解决类未被正确注册的问题。
• 验证路由定义：检查路由文件（如routes/web.php）中的路由指向是否正确，比如Route::get('/cubo', [CuboController::class, 'index']);需确保类名引用无误。

Ubuntu Apache环境下访问404错误 #

• 启用Apache重写模块：执行sudo a2enmod rewrite，然后重启Apache服务sudo systemctl restart apache2，Laravel依赖URL重写规则处理路由。
• 配置虚拟主机的AllowOverride：确保虚拟主机配置中DocumentRoot指向项目的public目录，且开启AllowOverride All，示例配置：

  <VirtualHost *:80>
      ServerName your-domain.com
      DocumentRoot /var/www/your-project/public
  
      <Directory /var/www/your-project/public>
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>
  

  修改后重启Apache生效。
• 修复目录权限：给storage和bootstrap/cache目录赋予Apache用户写入权限：

  sudo chown -R www-data:www-data /var/www/your-project/storage
  sudo chown -R www-data:www-data /var/www/your-project/bootstrap/cache
  sudo chmod -R 775 /var/www/your-project/storage
  sudo chmod -R 775 /var/www/your-project/bootstrap/cache
  

• 检查.htaccess文件：确认public目录下存在默认的.htaccess文件，内容需包含Laravel的URL重写规则，若文件缺失可从Laravel官方仓库复制默认内容。
• 核对大小写问题：Linux环境严格区分文件名大小写，确保控制器文件名、路由中的类名与本地一致，避免因大小写差异导致控制器无法找到进而触发404。

内容的提问来源于stack exchange，提问作者Ricardo Roel