@Value不支持注入数组配置，因其仅支持基础类型转换；应使用ConfigInterface::get()手动获取数组，或转为JSON字符串后json_decode解析。
Hyperf 中 @Value 无法直接注入数组类型配置
Hyperf 的 @Value 注解底层依赖 Hyperf\Config\Annotation\Value，它只支持将配置值当作字符串解析后做基础类型转换（如 int、bool），**不支持自动解析 YAML/JSON 格式的数组或对象**。如果你在 config/autoload/xxx.php 里写了 'list' => ['a', 'b']，再用 @Value("xxx.list") 注入，实际拿到的是空字符串或 null —— 因为注解处理器没走 Config 组件的完整取值逻辑，而是走了一条简化路径。
正确方式：用 ConfigInterface 手动获取数组配置
这是最可靠、最符合 Hyperf 设计意图的做法。数组配置本就该通过 ConfigInterface 获取，而非强行塞进 @Value。
实操建议：
- 在类构造函数或方法中注入
Hyperf\Config\ConfigInterface - 调用
$config->get('xxx.list', [])，第二个参数即默认值，类型明确是array - 如果需要类型安全，可在 PHPDoc 或 PHP 8+ 类型声明中标注返回值，例如：
/** @return array<int string> */</int>
示例：
class ExampleService
{
public function __construct(
private ConfigInterface $config
) {}
<pre class="brush:php;toolbar:false;">public function getItems(): array
{
return $this->config->get('app.items', []);
}}
想保留 @Value？只能转成 JSON 字符串再手动 json_decode
仅当配置项必须以字符串形式存在（比如环境变量或中心化配置中心下发），且你愿意承担解析开销和错误风险时才考虑。这不是推荐路径，但确实可行。
操作要点：
- 把数组写成 JSON 字符串，例如：
'items' => '["a","b","c"]'（注意引号要转义） - 用
@Value("app.items")注入为string，再json_decode($value, true) - 务必检查
json_last_error() === JSON_ERROR_NONE，否则会静默失败 - 无法享受 IDE 数组键提示、类型推导，也不利于配置校验
别踩坑：不要在 @Value 上加 PHP 类型提示或泛型
@Value 注解本身不解析 PHP 类型声明，下面这些写法都无效：
-
#[Value("app.list")] private array $list;→ 运行时仍是string或null -
#[Value("app.list")] private ?array $list = [];→ 默认值不会生效，字段仍为空 -
#[Value("app.list")] private Collection $list;→ 不会自动 new 实例，也不会调用collect()
Hyperf 的注解处理器只识别 string、int、bool、float 四种基础类型映射，其余一概按字符串处理。
数组配置天然属于结构化数据，它的读取逻辑应该交还给 ConfigInterface —— 这不是妥协，是让职责回归。尤其在微服务多配置源（YAML + ENV + Apollo）混合场景下，绕过 Config 直接用 @Value 反而会让行为变得不可预测。
