STM32CubeIDE在GitLab CI/CD中无头构建失败问题求助

修改项目名称后，本地STM32CubeIDE v1.10.1构建调试正常，Linux机器手动执行无头构建也成功，但GitLab Runner自动构建时出现以下错误：

URI: file:/builds/6tyu7Drk/0/path/projName is not valid in the workspace!

解决方案 #

1. 指定独立临时工作区 #

默认工作区可能指向Runner用户的home目录，存在权限或缓存冲突风险。在无头构建命令中显式指定项目内的临时工作区：

# 导入项目到临时工作区
/opt/st/stm32cubeide_1.10.1/headless-build.sh -data "$CI_PROJECT_DIR/.workspace" -import .
# 清理并构建项目
/opt/st/stm32cubeide_1.10.1/headless-build.sh -data "$CI_PROJECT_DIR/.workspace" -cleanBuild ProjName

每次构建都会生成全新的工作区，彻底避免旧配置干扰。

2. 排查配置文件中的残留绝对路径/旧名称 #

即使修改了.cproject和.project，仍可能有隐藏文件残留旧引用。执行以下命令检查：

grep -r "旧项目名称" "$CI_PROJECT_DIR" --include="*.xml" --include="*.project" --include="*.cproject" --include="*.launch" --include="*.properties"

替换所有找到的旧内容，确保配置文件中仅使用相对路径或正确的新项目名称。

3. 验证Runner执行环境权限 #

检查Runner用户对项目目录的读写权限，在流水线脚本中添加权限检查：

ls -ld "$CI_PROJECT_DIR"
whoami

如果权限不足，添加权限修正步骤：

chmod -R 755 "$CI_PROJECT_DIR"

4. 清理构建缓存 #

GitLab Runner可能缓存了旧的STM32CubeIDE工作区数据，在构建前清理：

# 清理默认工作区
rm -rf ~/STM32CubeIDE/workspace_1.10.1
# 清理临时工作区（如果使用了方案1）
rm -rf "$CI_PROJECT_DIR/.workspace"

也可在GitLab项目的「设置→CI/CD→缓存」中禁用构建缓存，确保每次构建环境干净。

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