在 Symfony 5.4+ 中，当服务构造函数参数被类型提示为 array 时，DI 容器默认无法自动推断其值，必须显式配置；解决方法包括在参数上设置默认值、使用参数绑定或直接在 services.yaml 中注入配置数组。
在 symfony 5.4+ 中，当服务构造函数参数被类型提示为 `array` 时，di 容器默认无法自动推断其值，必须显式配置；解决方法包括在参数上设置默认值、使用参数绑定或直接在 `services.yaml` 中注入配置数组。
在 Symfony 的依赖注入（DI）系统中，标量类型（如 string、int、bool）和数组（array）不会被自动解析——即使该数组来源于配置参数（如 %api_platform.collection.pagination%）。因此，当你定义如下服务类时：
class CollectionQueryFactory implements CollectionQueryFactoryInterface
{
private array $collectionOptions;
public function __construct(array $collectionOptions)
{
$this->collectionOptions = $collectionOptions;
}
}即使已在 services.yaml 中显式声明了参数：
App\Core\Shared\Query\CollectionQueryFactory:
arguments:
$collectionOptions: '%api_platform.collection.pagination%'仍可能报错：
Cannot autowire service "...CollectionQueryFactory": argument "$collectionOptions" of method "__construct()" is type-hinted "array", you should configure its value explicitly.
⚠️ 关键原因：Symfony 在严格模式下（尤其是未启用 bind 或未设默认值时）要求所有 array 类型参数必须可静态推断或显式提供。而 %api_platform.collection.pagination% 是一个容器参数（parameter），它本身是合法的，但 DI 编译器在分析构造函数签名时，若未看到默认值，会拒绝“猜测”该 array 应为何值。
✅ 推荐解决方案（三选一，按优先级排序）：
-
为构造函数参数添加默认空数组（最简洁、最常用）
修改构造函数签名，赋予array参数默认值：public function __construct(array $collectionOptions = []) { $this->collectionOptions = $collectionOptions; }此时，即使
services.yaml中未显式配置arguments，Symfony 也能安全完成自动装配；而你原有的 YAML 配置仍有效，会覆盖默认值：App\Core\Shared\Query\CollectionQueryFactory: arguments: $collectionOptions: '%api_platform.collection.pagination%' -
使用
bind全局绑定（适合多处复用同一数组配置）
在config/services.yaml的顶层bind下统一映射：services: _defaults: bind: array $collectionOptions: '%api_platform.collection.pagination%'此后所有接受
array $collectionOptions的服务（无论类名）都将自动注入该配置。 -
确保参数实际存在且为合法数组（排查性检查）
确认api_platform.collection.pagination在配置中已正确定义，例如在config/packages/api_platform.yaml中：api_platform: collection: pagination: client_items_per_page: true items_per_page: 30 page_parameter_name: 'page' enabled: true✅ 这会自动注册为参数
%api_platform.collection.pagination%（关联数组），可被安全引用。
? 注意事项：
- 不要试图用
!tagged_iterator注入普通配置数组——tagged_iterator仅适用于收集实现了某接口/拥有某标签的服务实例，不适用于纯配置数据。 - 若使用 PHP 8.1+，可考虑改用
list<t></t>或array<string mixed></string>提升语义，但 DI 行为不变，仍需显式配置或默认值。 - 运行
bin/console debug:container --parameters | grep pagination可验证参数是否已加载。
综上，为 array 参数添加 = [] 默认值是最轻量、最符合 Symfony 最佳实践的修复方式，既保持类型安全，又消除 DI 限制，同时兼容现有配置。
