Laravel包开发：composer dump-autoload权限错误及路由加载失败

我正在开发一个Laravel包，所有类和路由都已创建，但通过Web访问路由时，持续出现以下错误：

require(packages/uhgroup/UHTickets-laravel/src/routes/web.php): Failed to open stream: No such file or directory

执行composer dump-autoload命令时，还出现权限错误：

require(my_path\packages\uhgroup\Tickets-laravel\src\routes): Failed to open stream: Permission denied

我的项目文件/文件夹结构：

包的AppServiceProvider代码如下：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        $this->loadMigrationsFrom("packages/uhgroup/UHTickets-laravel/src/database/migrations");
        $this->loadRoutesFrom("packages/uhgroup/UHTickets-laravel/src/routes");
    }
}

问题分析与解决步骤 #

1. 修复路由文件路径错误 #

loadRoutesFrom方法要求传入具体的路由文件路径，而非目录。你当前传入的是目录路径，Laravel会尝试将目录当作文件加载，导致找不到web.php。

修改boot方法中的路由加载代码：

// 使用项目根目录基准的绝对路径
$this->loadRoutesFrom(base_path('packages/uhgroup/UHTickets-laravel/src/routes/web.php'));

2. 解决权限拒绝问题 #

针对不同系统执行对应操作：

• Linux/macOS：给包目录赋予读写权限，并确保与Web服务器用户一致

  sudo chmod -R 755 packages/uhgroup/UHTickets-laravel
  sudo chown -R www-data:www-data packages/uhgroup/UHTickets-laravel
  

• Windows：右键点击UHTickets-laravel目录，进入「属性」-「安全」，给当前用户和IIS_IUSRS组添加读写权限

3. 额外检查项 #

• 确认composer.json中已正确配置包的自动加载：

  "autoload": {
      "psr-4": {
          "Uhgroup\\UHTicketsLaravel\\": "packages/uhgroup/UHTickets-laravel/src/"
      }
  }
  

  修改后重新执行composer dump-autoload，确保自动加载映射生效。
• 检查目录名称拼写：错误提示中出现Tickets-laravel和UHTickets-laravel两个不同名称，确认实际目录名称，避免拼写不一致。

内容的提问来源于stack exchange，提问作者Lilian Carion