GitHub Action布尔输入debug_mode步骤判断失效问题求助

问题描述 #

开发GitHub Action时定义了boolean类型的debug_mode输入，默认值为false，但在步骤中通过if: ${{ inputs.debug_mode }}判断时，明明输出显示debug_mode is false，对应调试步骤仍会执行，且在workflow_run触发的场景下问题更明显。

输入定义：

inputs:
  debug_mode:
    description: "Controls the debug mode, boolean, true is for on. When turned on, it'll output certain information on certain steps. Mainly used for development, but use it as you please to inspect your env and variables."
    type: boolean
    required: false
    default: false

问题步骤示例：

steps:
  - name: Dump debug_mode
    run: echo "debug_mode is ${{ inputs.debug_mode }}"
    shell: bash
  - name: Dump context
    if: ${{ inputs.debug_mode}}
    uses: crazy-max/ghaction-dump-context@v2

原因分析 #

GitHub Actions在某些场景（如workflow_run传递上下文）中，可能会将布尔类型的输入自动转换为字符串类型。此时inputs.debug_mode的值是字符串"false"，而在GitHub表达式的条件判断中，非空字符串都会被视为true，导致条件成立，步骤被执行。

解决方案 #

1. 显式与布尔值比较 #

修改步骤的if条件，直接与true进行比较，GitHub表达式会自动处理类型转换：

- name: Dump context
  if: ${{ inputs.debug_mode == true }}
  uses: crazy-max/ghaction-dump-context@v2
- name: Dump build_path
  if: ${{ inputs.debug_mode == true }}
  run: echo "build_path is ${{ inputs.build_path }}"

2. 使用fromJSON转换为布尔类型 #

如果输入确实被解析为字符串，用fromJSON将其转换为布尔值后再判断：

- name: Dump context
  if: ${{ fromJSON(inputs.debug_mode) }}
  uses: crazy-max/ghaction-dump-context@v2

这个方法能确保无论输入是布尔类型还是字符串类型，都能被正确解析为布尔值进行判断。

3. 检查Action调用时的赋值方式 #

在调用该Action的Workflow中，确保debug_mode的赋值是布尔类型，不要加引号（加引号会变成字符串）：

uses: skywarth/vite-vue-github-pages-deploy@v1
with:
  debug_mode: false  # 正确：布尔类型
  # debug_mode: "false" 错误：字符串类型

验证方法 #

可以添加一个步骤查看输入的类型，确认问题根源：

- name: Check debug_mode type
  run: echo "debug_mode type: ${{ typeof(inputs.debug_mode) }}"

如果输出是string，说明输入被转换为字符串类型，需要用上述方案处理；如果是boolean，则说明是其他场景的表达式解析问题，优先使用方案1。

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