GitLab CI 脚本之 CI_COMMIT_AUTHOR

GitLab执行CI脚本时报了这样的错误:

bash 复制代码
Running with gitlab-runner 19.3.1 (a27f5034)
  on Test-Machine abc123xyz, system ID: s_xxxxxxxxxxxx
Resolving secrets
Preparing the "shell" executor
00:00
Using Shell (powershell) executor...
Preparing environment
00:00
Running on Test-Machine...
Getting source from Git repository
00:02
At line:274 char:29
+ ${CI_COMMIT_REF_PROTECTED}="true"
+                             ~~~~~
Unexpected token 'true"
${env:CI_COMMIT_REF_PROTECTED}=${CI_COMMIT_REF_PROTECTED}
${CI_COMMIT_TIMESTAMP}="2026-10-10T21:40:55+08:00"
${env:CI_COMMIT_TIMESTAMP}=${CI_COMMIT_TIMESTAMP}
${CI_COMMIT_AUTHOR}="user' in expression or statement.
At line:278 char:34
+ ${CI_COMMIT_AUTHOR}="user <user@example.com>"
+                                              ~
The '<' operator is reserved for future use.
At line:332 char:104
+ ... \builds\abc123xyz\0\user\automationtest\.git\index.lock"
+                                                             ~
The string is missing the terminator: ".
At line:1 char:3
+ & {
+    ~
Missing closing '}' in statement block or type definition.
    + CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
    + FullyQualifiedErrorId : UnexpectedToken

Gitaly correlation ID: 01MXXXXXXXXXXXXXXXXXXXXXX
Cleaning up project directory and file based variables
00:01
At line:272 char:29
+ ${CI_COMMIT_REF_PROTECTED}="true"
+                             ~~~~~
Unexpected token 'true"
${env:CI_COMMIT_REF_PROTECTED}=${CI_COMMIT_REF_PROTECTED}
${CI_COMMIT_TIMESTAMP}="2026-10-10T21:40:55+08:00"
${env:CI_COMMIT_TIMESTAMP}=${CI_COMMIT_TIMESTAMP}
${CI_COMMIT_AUTHOR}="user' in expression or statement.
At line:276 char:34
+ ${CI_COMMIT_AUTHOR}="user <user@example.com>"
+                                              ~
The '<' operator is reserved for future use.
At line:336 char:110
+ ... \builds\abc123xyz\0\user\automationtest.tmp\gitlab_runner_env"
+                                                                 ~
The string is missing the terminator: ".
At line:1 char:3
+ & {
+    ~
Missing closing '}' in statement block or type definition.
    + CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
    + FullyQualifiedErrorId : UnexpectedToken

At line:1 char:1
+ }
+ ~
Unexpected token '}' in expression or statement.
    + CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
    + FullyQualifiedErrorId : UnexpectedToken

ERROR: Job failed: exit status 1

公司服务器用的powershell版本是5.1,这里面有个坑,CI_COMMIT_AUTHOR 自动获取的值包含了邮箱:xxx<xxx@wwww.com>。

在 PowerShell 中,< 和 > 是保留的重定向符号。当 GitLab Runner 自动把这个变量转换成 PowerShell 脚本注入时,由于内部引号或转义处理不当,导致 PowerShell 把 < 当成了语法错误,并且把整段字符串的引号截断了(The string is missing the terminator: ")。

连锁解析崩溃:

因为前面某一个环境变量(如包含空格、单双引号、尖括号的 Author 或 Commit Message)破坏了 PowerShell 的字符串闭合,导致后面生成的 PowerShell 临时环境脚本直接语法报错(ParserError),最终引发整个 Job 失败。

pwsh (powershell7)可以解决这个问题,但是我不想升级,所以采用了另外的方法:

在全局 variables 里面显式声明并覆盖 CI_COMMIT_AUTHOR:

bash 复制代码
variables:
  CI_COMMIT_AUTHOR: "xxx"

因为GitLab CI 允许在 YAML 的 variables 中直接重写默认的内置环境变量。通过把带有尖括号 <...> 的邮箱地址去掉,只保留纯文本名字 xxx,就能彻底避开 PowerShell 对 < 符号的语法审查和引号截断错误。

再具体说下CI_COMMIT_AUTHOR,它是GitLab的内置属性,是 GitLab 在每次触发 Pipeline 时自动生成并注入的系统变量,用来记录当前触发这次提交(Commit)的作者信息。它的默认格式是:作者名字 <邮箱地址>。

通过在全局 variables 中显式声明后,实际上是给 GitLab 发了一条指令:"不要使用系统默认那个带尖括号和邮箱的复杂字符串来初始化这个环境变量,请直接用我给你的这个纯文本(没有特殊符号)来代替它!"这样一来,Runner 注入到 PowerShell 里的语句就变成了干净的 $env:CI_COMMIT_AUTHOR="xxx",从而完美避开了 PowerShell 的语法拦截。

相关推荐
亚那迦基2 天前
24小时高危漏洞速报,互联网惊天危机来临!PHP、Java、Node.js、NGINX、GitLab无一幸免,看看你家是否中招
nginx·gitlab·php
考虑考虑2 天前
git刷新远程分支列表
git·后端·gitlab
工程小白菜3 天前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程
Frankie_stand3 天前
工程工具链实战指南:从版本管理、构建打包到 CI 与日志分析的落地方法
ci/cd·无人机
Mr_万能胶3 天前
官方发布,不烧心的 AOSP 编译提速技巧
android·ci/cd·架构
芜名氏6 天前
API 文档生成工具——SpringDoc
java·spring boot·ci/cd·设计规范
aifannihao7 天前
GitHub Actions 锁文件实测:6 个 uses 只锁住 2 个
python·ci/cd·标准库·供应链安全·github actions
J心流9 天前
CI-CD配置流程
ci/cd
IT大白鼠10 天前
GitLab 未认证 RCE 应急实战CVE-2026-97229(CVSS 10.0)
网络·安全·gitlab
Frankie_stand11 天前
测试自动化实战指南:从脚本化、自动判据到 CI 集成的完整落地路径
android·ci/cd·自动化