Helm模板range运算符在列表为空时仍执行的问题排查

你的问题在于：当directories列表为空时，range循环确实不会生成任何脚本内容，但args对应的字符串会变成空值。此时/bin/sh -c ""仍然会被执行——shell启动后执行空命令随即退出，所以容器还是会运行一次，这就是你看到的“至少执行一次”的现象。

你提到用if/else判断列表长度后仍未生效，大概率是条件判断的范围不对，或者语法细节出错（比如缩进、模板标签使用不当）。

方案1：仅当directories非空时渲染容器 #

如果不需要在directories为空时保留这个容器，可以把整个容器块用条件判断包裹，这样空列表时容器会被完全跳过：

{{- if gt (len .Values.directories) 0 }}
containers:
  - name: create-directory
    image: "{{ .Values.container.image }}"
    imagePullPolicy: IfNotPresent
    command: ["/bin/sh", "-c"]
    args:
      - |
        {{- range .Values.directories }}
        dir_path="/var/log/at/{{ . }}"
        echo $dir_path

        # Check if the directory exists
        if [ -d "$dir_path" ]; then
          echo "Directory $dir_path already exists."
        else
          # Create the directory
          mkdir -p "$dir_path" && echo "Directory $dir_path created."
        fi
        {{- end }}
{{- end }}

方案2：保留容器但空列表时不执行操作 #

如果必须保留容器，可在脚本内添加判断，空列表时直接输出提示并退出：

containers:
  - name: create-directory
    image: "{{ .Values.container.image }}"
    imagePullPolicy: IfNotPresent
    command: ["/bin/sh", "-c"]
    args:
      - |
        {{- if gt (len .Values.directories) 0 }}
        {{- range .Values.directories }}
        dir_path="/var/log/at/{{ . }}"
        echo $dir_path

        # Check if the directory exists
        if [ -d "$dir_path" ]; then
          echo "Directory $dir_path already exists."
        else
          # Create the directory
          mkdir -p "$dir_path" && echo "Directory $dir_path created."
        fi
        {{- end }}
        {{- else }}
        echo "No directories specified to create, exiting."
        {{- end }}

常见错误点说明 #

如果你之前尝试的判断未生效，可能是以下原因：

• 仅将range块包裹在if中，但未处理空列表时的脚本内容，导致args仍为空字符串，shell依然会启动执行空命令。
• 条件判断语法错误，比如误用{{ if .Values.directories }}（虽然空切片在Go模板中视为false，但如果values中directories被显式设为null而非[]，可能会有差异；用len判断更可靠）。
• 模板标签的缩进或空格使用不当，导致Helm解析条件判断时出错。

内容的提问来源于stack exchange，提问作者Somnath Pathak