使用GitHub Workflow删除AWS CloudFormation非空栈报错：未知选项--force

错误原因 #

你遇到的Unknown options: --force错误，是因为GitHub Actions默认环境中的AWS CLI版本过低，不支持--force参数——这个参数是AWS CLI v2.10.0及以上版本才新增的，而你本地终端的CLI版本足够新，所以能正常执行。

解决方案 #

方案1：升级Workflow中的AWS CLI版本 #

在执行删除栈命令前，先添加升级CLI的步骤，确保版本支持--force参数：

steps:
  - name: 升级AWS CLI至最新版本
    run: |
      curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
      unzip -q awscliv2.zip
      sudo ./aws/install --update
  - name: 删除CloudFormation栈
    run: aws cloudformation delete-stack --stack-name ${{env.LAMBDA_STACK_NAME}} --force

方案2：不依赖--force，手动清理资源后删栈 #

如果不想升级CLI，可以先清理栈内的关联资源（比如Lambda函数、S3桶等），再执行删除栈命令。这种方法需要明确栈内所有资源，操作相对繁琐：

steps:
  - name: 删除关联Lambda函数
    run: aws lambda delete-function --function-name YOUR_LAMBDA_FUNCTION_NAME
  - name: 删除CloudFormation栈
    run: aws cloudformation delete-stack --stack-name ${{env.LAMBDA_STACK_NAME}}

注意事项 #

--force参数会绕过CloudFormation的资源保护机制，强制删除包含资源的栈，使用前请确认确实不需要保留栈内的任何资源。

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