CircleCI中curl --output命令执行失败的问题排查

配置文件内容 #

version: 2.1

parameters:
  project-url:
    type: string
    default: "none"

jobs:
  build:
    working_directory: ~/project
    docker:
      - image: cimg/node:14.19.1
    steps:
      - checkout
      - run:
          name: Download Project File
          command: curl << pipeline.parameters.project-url >> --output build/tmp.zip

问题现象 #

传入以下URL时：

https://storage.googleapis.com/project.appspot.com/user_uploads/test/projects/test/project.zip?GoogleAccessId=project%40appspot.gserviceaccount.com&Expires=17017600&Signature=mNtazJLvfMXOw6rnzcxUCmgVU8prTGv%2dQcE5KCz4D08vHh3k%2B9ppsTmuW9WhpK8KA2UhDjohWjVq4ITGoOQ%2FRsw%2BFfdurVGGCD1am00FW%2FdEbRxgYiqEAcGW%2F9pAe%2FudeReWZNzZC8QGhVxBvlZ3Fm2HKTkGobRqOEVeayUV%2B8wiIJVCjnB9ewlE2WT8hYAJWXPd1Pm9Bcjd2RTiqmwhQ4%2Fe6xlWg7liexPJUEFCrft0YBJkbWWOjbzy8mp%2Fbsgjt%2B3iCMF2MF%2Fvh%2FuSUPCQ%3D%3D

出现错误：

/bin/bash: --output: command not found

但传入以下转义过的URL时正常：

https://firebasestorage.googleapis.com/v0/b/project.appspot.com/o/user_uploads%2FnO1zNY9JO9boxQagw2%2Fprojects%2FCGzf6GM8g88YWC.zip\?alt\=media\&token\=e50cfa59-c723-488f-9d11-2c2ac7ac

问题原因 #

核心问题是未对URL参数进行引号包裹，导致bash解析命令时将URL中的特殊字符（如&）当作shell元字符处理：

• URL中的&会被bash识别为“后台执行命令”的分隔符，使得curl命令在&处被截断，后面的Expires=...等内容被当作独立命令执行，最终--output被当成了新的未定义命令，触发报错。
• 第二个URL中的&已被转义（\&），bash不会将其解析为元字符，因此整个URL能作为一个完整参数传递给curl。

解决办法 #

修改command行，用双引号包裹URL变量，确保bash将整个URL视为单个参数：

command: curl "<< pipeline.parameters.project-url >>" --output build/tmp.zip

这样无论URL中包含多少shell特殊字符，都会被完整传递给curl，避免被bash拆分解析。

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