symfony 4 中自定义服务工厂需先注册工厂服务再通过 factory 键引用，工厂类推荐用静态方法返回目标对象，yaml 配置必须分两步且 arguments 传给工厂方法而非构造函数。
在 Symfony 4 中，自定义服务工厂（factory service）是解耦对象创建逻辑、复用初始化逻辑或桥接旧系统的关键手段。它不复杂，但配置稍有不慎就容易报错——核心在于：工厂本身要先注册为服务，再被其他服务通过 factory 键引用，不能“嵌套写在 arguments 里”。
工厂类必须可调用且返回正确类型
你的工厂类（比如 App\Service\Factory\UserFactory）需提供一个静态或实例方法，返回目标对象（如 UserRepository）。推荐用静态方法，避免额外依赖：
namespace App\Service\Factory;
<p>use App\Repository\UserRepository;</p><p>class UserFactory
{
public static function create(string $env): UserRepository
{
return new UserRepository($env === 'prod' ? 'prod_db' : 'test_db');
}
}</p>在 services.yaml 中正确定义工厂服务和使用方
YAML 不支持 XML 那种内联 factory 写法。必须拆成两步：先定义工厂服务（哪怕只是容器代理），再让目标服务用它创建实例：
- 工厂服务本身不需要 class（除非你要注入它），但建议显式声明以利 IDE 和调试
- 使用方服务的 factory 值格式为
['@service_id', 'method_name']或['@service_id', 'methodName'] - arguments 是传给工厂方法的参数，不是传给目标类构造函数的
# config/services.yaml
services:
# 步骤1：注册工厂服务（这里用 service_container 作为工厂，也可用自定义类）
app.user_factory:
class: App\Service\Factory\UserFactory
# 可选：若工厂需要其他依赖，可在这里注入
<h1>步骤2：用工厂创建目标服务</h1><p>App\Repository\UserRepository:
factory: ['@app.user_factory', 'create']
arguments: ['%kernel.environment%']</p><h1>注意：此处 arguments 传给 create() 方法，不是 UserRepository::__construct()</h1>
常见错误与避坑提示
以下写法都会失败：
-
arguments: [{factory: ['@app.user_factory', 'create'], arguments: ['%kernel.environment%']}]—— YAML 把它当数组字面量，不是服务 -
factory: 'App\Service\Factory\UserFactory::create'—— Symfony 4.4+ 不支持字符串形式的静态工厂调用（仅限 callable 数组） - 忘记为工厂服务加
@符号，如写成factory: [app.user_factory, 'create']—— 容器找不到该 ID
进阶：用编译器 Pass 动态注册大批量工厂服务
如果要为几十个 Repository 都配 factory，手动写太累。可以写一个 CompilerPass，扫描命名空间自动注册：
- 创建
src/DependencyInjection/Pass/RepositoryFactoryPass.php - 在
build()方法中遍历Repository类，为每个生成一个带 factory 的服务定义 - 在
Kernel::build()中添加该 pass：$container->addCompilerPass(new RepositoryFactoryPass());
这样既能保持配置简洁，又能统一控制工厂行为（如环境适配、日志埋点等）。
