Laravel 9开发包中Factory类无法正常解析的问题求助

可能原因及对应解决方案 #

1. 未更新Composer自动加载缓存 #

编辑器能识别类但运行时找不到，多数是Composer自动加载缓存未同步。执行以下命令更新：

# 先在包目录下执行
composer dump-autoload

# 再在主项目目录下执行
composer dump-autoload

2. 校验自动加载配置与文件结构一致性 #

确认包的composer.json中PSR-4映射规则与实际文件结构严格匹配：

• Zam\Authentication\Factories\ 必须对应包根目录下的database/factories/文件夹
• UserPhoneFactory.php 文件需直接放在database/factories/目录下
• 文件名与类名完全一致（Linux系统需注意大小写敏感）

3. 确保包在主项目中正确引入 #

如果是本地开发的包，需在主项目composer.json中配置本地仓库：

"repositories": [
    {
        "type": "path",
        "url": "./packages/zam/authentication"
    }
]

然后重新安装包：

composer require zam/authentication

4. 在包服务提供者中注册Factory自动发现（可选） #

尽管模型已重写newFactory方法，额外注册发现逻辑可规避潜在问题。在包的AuthenticationServiceProvider中添加：

<?php

namespace Zam\Authentication;

use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\ServiceProvider;

class AuthenticationServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Factory::guessFactoryNamesUsing(function (string $modelName) {
            return 'Zam\\Authentication\\Factories\\' . class_basename($modelName) . 'Factory';
        });
    }
}

5. 核对模型的newFactory方法命名空间 #

确保模型中newFactory方法的命名空间无拼写错误：

protected static function newFactory()
{
    return \Zam\Authentication\Factories\UserPhoneFactory::new();
}

验证操作 #

完成上述步骤后，重新运行Seeder测试：

php artisan db:seed --class=SiteUserSeeder

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