如何通过Helm(Go模板)加载数组值，解决SpringBoot列表识别异常

API 探路者

2026-7-15

修复SpringBoot读取环境变量列表为单个字符串的问题

解决方案：修改_env模板生成逗号分隔的环境变量值

将你的_env文件模板修改为以下形式，生成逗号分隔的字符串值，SpringBoot会自动将其解析为List<String>：

- name: VALUES_MY_VALUES  # 变量名需匹配SpringBoot绑定规则，对应配置类prefix="values" + 属性my_values
  value: "{{ join \",\" .Values.values.my_values }}"

如果值中包含特殊字符（如空格、逗号），需要给每个值添加引号，使用如下模板：

- name: VALUES_MY_VALUES
  value: "{{ range $idx, $val := .Values.values.my_values }}{{ if $idx }},{{ end }}{{ $val | quote }}{{ end }}"

SpringBoot的List绑定规则：
SpringBoot的@ConfigurationProperties默认将逗号分隔的字符串解析为List<String>。你之前生成的空格分隔带引号字符串（如"value_1" "value_2" "value_3"）会被Spring当作单个字符串处理，导致List大小为1。
环境变量名匹配：
配置类前缀为values、属性为my_values，对应的环境变量名应为VALUES_MY_VALUES（大写字母+下划线分隔，Spring会自动映射到values.my_values）。若仍使用VALUES_IN_LIST作为变量名，需在application.yml中添加映射：
```
values:
  my_values: "${VALUES_IN_LIST}"
```
确保配置生效：
主类上需添加@EnableConfigurationProperties(MyValues.class)，启用配置属性绑定。