在 Symfony 5.4+ 中，当服务构造函数参数被声明为 array 类型提示却未显式配置时，DI 容器会报错；解决方法是为该参数提供默认值（如 = []），或在 services.yaml 中明确绑定数组值（需确保引用的参数确为 PHP 数组）。
在 symfony 5.4+ 中，当服务构造函数参数被声明为 `array` 类型提示却未显式配置时，di 容器会报错；解决方法是为该参数提供默认值（如 `= []`），或在 `services.yaml` 中明确绑定数组值（需确保引用的参数确为 php 数组）。
当你在 Symfony 服务中定义一个构造函数参数并使用 array 类型提示（如 public function __construct(array $collectionOptions)），Symfony 的自动装配（autowiring）机制无法自动推断该 array 应该注入什么具体值——因为 array 不是一个类或接口，DI 容器没有对应的“服务别名”可匹配。此时必须显式配置该参数，否则会抛出类似以下错误：
Cannot autowire service "App\Core\Shared\Query\CollectionQueryFactory": argument "$collectionOptions" of method "__construct()" is type-hinted "array", you should configure its value explicitly.
✅ 推荐解决方案：添加默认空数组（最简洁、安全）
修改构造函数签名，为 $collectionOptions 提供默认值 = []：
class CollectionQueryFactory implements CollectionQueryFactoryInterface
{
private array $collectionOptions;
public function __construct(array $collectionOptions = [])
{
$this->collectionOptions = $collectionOptions;
}
// ...
}
此举后，Symfony 将认为该参数是“可选的”，不再强制要求显式配置，同时保持类型安全与运行时健壮性（空数组是合法的默认状态）。
⚠️ 若坚持显式注入（如需非空配置）：确保 %api_platform.collection.pagination% 是真实 PHP 数组
你已在 services.yaml 中尝试：
App\Core\Shared\Query\CollectionQueryFactory:
arguments:
$collectionOptions: '%api_platform.collection.pagination%'
这仅在 %api_platform.collection.pagination% 实际解析为一个 PHP 数组（而非字符串或未定义参数）时才有效。请验证该参数是否正确定义于 config/packages/api_platform.yaml 或 config/services.yaml 中，例如：
# config/packages/api_platform.yaml
api_platform:
collection:
pagination:
client_items_per_page: true
items_per_page: 30
page_parameter_name: 'page'
enabled: true
⚠️ 注意：上述 YAML 配置不会自动导出为一个 PHP 数组参数！%api_platform.collection.pagination% 并非 Symfony 原生参数占位符 —— ApiPlatform 的配置默认不以参数形式暴露。若你确实需要将其作为数组注入，应显式定义自定义容器参数：
# config/services.yaml
parameters:
app.collection_options:
items_per_page: 30
page_parameter_name: 'page'
enabled: true
services:
App\Core\Shared\Query\CollectionQueryFactory:
arguments:
$collectionOptions: '%app.collection_options%'
然后在构造函数中仍建议保留默认值（防御性编程）：
public function __construct(array $collectionOptions = [])
{
$this->collectionOptions = $collectionOptions;
}
? 小结
- 类型提示
array≠ 可自动装配的服务，必须显式配置或设默认值； - 添加
= []是最轻量、符合 PSR-12 和 Symfony 最佳实践的方式； - 若依赖外部配置（如
%...%），务必确认该参数已正确定义且类型为array； - 避免使用
@tagged_iterator注入纯数组——它适用于服务集合（iterable<someservice></someservice>），不适用于标量数组。
这样配置后，CollectionQueryFactory 即可被正常实例化和注入，无 DI 报错。
