Kestra工作流中条件运算符在脚本任务中的正确使用方式

在Kestra工作流自动化平台中，开发者经常需要在脚本任务中使用条件逻辑来控制命令执行。一个典型场景是根据输入参数动态生成命令行参数。本文深入分析条件运算符在Commands任务中的正确使用方法。

问题现象

当开发者尝试在脚本任务的commands属性中直接使用三元条件运算符时，例如：

commands:
  - echo {{ inputs.export ? '-f' : '' }}

会遇到YAML解析错误，提示"Unexpected flow-map-end token in YAML stream"。这是因为YAML解析器在处理未引用的条件表达式时会产生歧义。

根本原因

Kestra使用Pebble模板引擎处理表达式，但这些表达式首先需要被正确解析为YAML。当条件表达式包含特殊字符如问号(?)、冒号(:)时，YAML解析器会将其误认为是流映射(flow mapping)语法。

解决方案

正确的做法是将整个包含条件表达式的字符串用双引号包裹：

commands:
  - "echo {{ inputs.export ? '-f' : '' }}"

这种写法明确告诉YAML解析器：

1. 引号内的内容是字符串字面量
2. 其中的花括号和特殊字符不应作为YAML语法解析
3. 保留原始内容供后续的Pebble模板引擎处理

替代方案

对于复杂条件逻辑，可以采用中间任务预渲染值的模式：

tasks:
  - id: render_flag
    type: io.kestra.plugin.core.debug.Return
    format: "{{ inputs.export ? '-f' : '' }}"
  
  - id: run_script
    type: io.kestra.plugin.scripts.python.Commands
    commands:
      - echo {{ outputs.render_flag.value }}

这种方法虽然增加了一个任务，但提高了可读性，特别适合：

• 表达式特别复杂时
• 同一个值需要多处引用时
• 需要调试中间值时

最佳实践建议

1. 始终对包含模板表达式的命令使用引号
2. 简单条件逻辑可直接使用三元运算符
3. 复杂逻辑考虑拆分为多个任务
4. 在开发阶段使用debug.Return任务验证表达式结果
5. 注意YAML中单引号和双引号的区别（双引号允许转义字符）

通过遵循这些模式，开发者可以充分利用Kestra的条件逻辑能力，同时避免YAML解析问题，构建出更健壮的工作流。