代码仓
中
构建问题自主定位手册
更新时间: 2026/11/17
在AtomGit上查看源码

本手册面向 openUBMC/manifest 仓构建问题的自主定位,按两个场景组织:

  • 场景一:流水线问题——PR 门禁 CI 失败,着重操作方法:怎么看日志、怎么重跑、怎么排查、怎么推包。
  • 场景二:本地构建——本地 bingo build 等命令失败,着重从现象找原因:错误特征 => 根因 => 处理。

问题统一归为五类:触发失败、构建失败、门禁失败、制品缺失、权限异常。其中触发失败与门禁失败仅流水线场景存在,本地不涉及;本地构建的「跑不起来」多为环境问题(初始化、SDK 配套、网络代理等),单列一节。本地环境类问题的完整报错清单另见构建常见问题。

问题分类总览 ​

问题类别流水线侧(场景一)本地侧(场景二)
触发失败CI 未触发(草稿 PR)、排队、运行被抢占、流水线配置问题—(本地无触发环节,「跑不起来」多为环境问题)
构建失败编译构建/依赖校验 FAILED、CI 镜像问题编译报错、依赖版本冲突、manifest 配置错误
门禁失败门禁检查任务 FAILED、needs-issue 等标签阻塞—(仅流水线有门禁,推送前自检见门禁失败)
制品缺失组件制品未发布或 revision 不同步制品核对、本地 conan 缓存异常
权限异常日志 403、认证卡住、CI 内 sudo 受限git/conan 凭证、docker 组、mount 权限

快速索引 ​

看到以下现象时,直接跳转对应章节:

场景现象章节
流水线PR 创建/更新后没有 CI 评论,或流水线一直排队未运行触发失败
流水线CI 结果表中「编译构建」系列任务或「依赖校验」为 FAILED构建失败
流水线「PR描述检查」「pre-commit检查」等门禁任务 FAILED,或 PR 被 needs-issue / needs-squash 等标签阻塞门禁失败
流水线构建日志提示 was not found in remote、recipe revision/包哈希不匹配、reference is not a tree制品缺失、怎么推包
流水线日志出现 403、Username for、permission denied、认证卡住、mount 失败权限异常(流水线侧)
本地bingo build / bingo analysis / bingo test 失败,需区分环境、缓存、制品还是代码问题场景二:本地构建

场景一:流水线问题 ​

manifest 仓流水线定义于 .gitcode/workflows/PR-pipeline_manifest.yml,实际任务由 openUBMC/openubmc-ci 仓的 ci-build.yml 提供。触发方式:

  1. PR 打开、重新打开、更新(推送新提交)时自动触发。
  2. 在 PR 下评论 /retest 手动重跑。
  3. 草稿(Draft)PR 不触发 CI。草稿 PR 即标记为「尚未完成」的 PR:标题带 Draft: 前缀,创建 PR 时选择「转换为草稿」,或在 PR 页面评论区右下角点击「转换为草稿」即可标记。
  4. 流水线并发上限 10,超出后排队(Queue),同一 PR 的新运行会抢占旧运行。

怎么看日志 ​

CI 结束后由机器人(openubmc-ci-bot)在 PR 评论中回帖结果表,表内任务名与流水线 Job 的对应关系如下:

结果表任务名流水线 Job检查内容
pre-commit检查pre-commit代码格式检查,含 semgrep 敏感信息扫描(命中即阻断)
PR描述检查check_messagePR 描述模板 5 个字段(功能描述/修改方案/验证方案/测试建议/自验证报告)均需填写且每字段不少于 10 个字符
修改行数检查Test_line_limit_check变更行数默认不超过 1000 行,超限打 limit_1k_failed 标签
防投毒检查poison恶意代码扫描(openlibing malicious-code-scan)
开源合规检查sca开源合规 SCA 扫描(含 LICENSE、版权声明)
编译构建buildbingo build -b openUBMC -bt debug 主产品构建
编译构建1712build_17121712 单板构建
编译构建3095build_30953095 单板构建
编译构建AST2600build_ast2600AST2600 单板构建
依赖校验Test_dependency_checkbingo analysis --rebuild 依赖解析校验

通用定位路径(PR -> job -> 日志 -> 问题),共四步:

  1. PR 页:打开 PR,在评论区找到 openubmc-ci-bot 的回帖。
    • 有「CI已开始运行,查看流水线详情」评论:点击其中的流水线链接进入第 2 步。
    • 没有任何 CI 评论:属于触发失败,见触发失败。
    • 有结果表(任务名称/结果表格):先看哪个任务为 FAILED,再点该评论之前最近一次「CI已开始运行」中的流水线链接。
  2. 流水线页:在运行记录中找到失败的那次运行(时间与结果表回帖对应),点开「CI门禁」阶段。
  3. Job 日志:点击失败任务(如「编译构建」)进入日志,定位到标红的失败步骤(如「执行构建」)。构建类 Job 失败时会自动打印 temp/log/task.log 的最后 1000 行,日志中可直接搜索 task.log、ERROR、FAILED、not found 等关键字。
  4. 问题定界:按日志错误特征判断根因类别(见五类问题排查),再执行对应处理。

怎么重跑 ​

命令适用场景注意事项
/retestCI 未触发、疑似环境抖动、PR 描述修改后门禁类检查结论不随重跑变化,须整改 PR 本身;重复触发会重新排队并抢占旧运行
/check-pr检视意见全部处理完(含回复或解决)后通过后机器人移除 unresolved-reviews 等阻塞标签
/check-issue已关联 Issue 但 needs-issue 标签仍在前提是已按格式完成关联
  • 排队(Queue)一般数分钟内自行缓解,无需重复触发;重复触发反而会再次抢占排队位置。
  • 运行被抢占取消属正常行为,以最后一次运行结果为准。
  • 门禁失败为什么重跑无效,见门禁失败。
  • 完整命令表(含 /publish、/ai review、/lgtm、/approve)见附录。

五类问题排查 ​

触发失败 ​

现象(如何被发现)

  • PR 创建或推送更新后,评论区迟迟没有「CI已开始运行」评论。
  • 流水线页面显示运行处于排队(Queue)状态长时间不动。
  • 结果表回帖迟迟不来,但流水线页显示运行已被新运行抢占取消。

定位步骤

  1. PR 页确认 PR 状态:是否为草稿(Draft)PR。识别方法:PR 标题带 Draft: 前缀,评论区右下角显示「标记为就绪(Ready for review)」按钮。草稿 PR 不触发 CI。
  2. PR 页确认最新推送是否成功:打开 PR 的「提交」标签页,核对最新一条提交的短 SHA 是否与本地 git log -1 一致。本地有新提交但 PR 提交列表未更新,通常是未推送或推送到了其他分支。
  3. 进入仓库「流水线/CI」页面,按 PR 号过滤运行记录:
    • 无任何运行记录:触发事件未到达或被平台过滤。
    • 有记录但状态为排队:并发资源紧张(并发上限 10)。
    • 有记录但被取消(Canceled):被同 PR 的更新抢占,属正常行为,以最后一次运行为准。
  4. 若触发配置疑似异常,检查 .gitcode/workflows/PR-pipeline_manifest.yml 的 on: 配置是否被改动(近期是否有人合入流水线配置变更)。

判断依据

  • 草稿 PR + 无 CI 评论 => 平台设计行为,非故障。
  • 非草稿 + 无 CI 评论 + 无运行记录 => 触发失败。
  • 运行记录存在但长时间排队(Queue)=> 资源排队,非代码问题。
  • 运行被抢占取消 => 正常,看最后一次运行结果即可。

处理建议

  1. 草稿 PR 请先标记为就绪(Ready for review)。
  2. 非草稿 PR 无 CI 评论时,在 PR 下评论 /retest 手动触发。
  3. /retest 仍无反应时,检查流水线文件与仓库 webhook 配置,或联系 manifest 仓所属 SIG sig-release-management 的维护者;联系人名单见 manifest 仓该 PR 机器人欢迎评论的「联系指引」一节。
  4. 流水线环境自身问题(如镜像构建脚本缺文件、在线拉取公钥不可达等,参考 PR !2491):修 dockerfile/初始化脚本,并在 PR 描述中说明触发版本点(如「26.09 tag 起必现」),便于评审。

构建失败 ​

指 CI 结果表中「编译构建」「编译构建1712」「编译构建3095」「编译构建AST2600」「依赖校验」为 FAILED。这是最常见的失败类别,其中相当一部分根因是制品缺失,定位时注意交叉判断。

现象(如何被发现)

  • CI 结果表中一个或多个构建任务 FAILED。典型组合:
    • 全部构建任务 + 依赖校验一起失败:多为制品缺失或全局配置问题。
    • 仅部分单板失败(如仅 AST2600):多为板间差异配置问题。
  • /retest 重跑后依然失败(非环境抖动)。

定位步骤

  1. 按怎么看日志进入失败 Job 日志,找到 bingo build 报错段落(Job 会自动带出 temp/log/task.log 尾部 1000 行)。
  2. 在日志中依次搜索以下关键字并记录命中行:not found in remote、revision、ModuleNotFoundError、Unable to locate package、CMake Error、internal compiler error、Killed、mount、checkout、mib。
  3. 按命中关键字跳转判断:
    • 命中 not found in remote、revision 不匹配、checkout / reference is not a tree => 制品缺失,见制品缺失与怎么推包。
    • 其余关键字(ModuleNotFoundError、Unable to locate package、CMake Error、internal compiler error、Killed、mount、mib)见下文典型场景对照,逐条比对根因与修复案例。
  4. 本地复现验证:在 manifest 仓执行与 CI 相同的命令 bingo build -b openUBMC -bt debug(单板失败则加对应 -b 参数),对照 temp/log/task.log。

典型场景对照(错误特征 => 根因 => 修复案例)

日志错误特征根因真实案例
ModuleNotFoundError: No module named 'exceptions'环境镜像构建脚本缺文件:init.py 重构后新增依赖,dockerfile COPY 清单未同步PR !2491(修复镜像构建必现失败)
Unable to locate package(apt install 阶段)镜像构建期在线拉取源公钥不可达,被静默吞掉后安装失败PR !2491(公钥随仓内置,消除在线依赖)
mib 编译报 ocpCardIndex 相关错误mib 定义超出合法范围(如未声明 0-255 范围约束)PR !2418(修复 mib 编译报错)
CMake Error组件 CMake 构建配置或依赖声明错误,日志中会给出具体组件名本地复现定位问题组件后修复(见处理建议)
新增约束/配置文件后多单板构建失败产品配置(如 option_constraints)与部分单板不兼容PR !2243(四单板新增约束首版,1712/3095/AST2600 构建失败)
仅 AST2600 等特定单板失败单板差异化配置被破坏(该单板特有组件/权限配置)PR !2470(mtd 设备节点权限修改致 AST2600 构建失败)
internal compiler error: Killed构建机/本地内存不足参考构建常见问题
mount 阶段卡住失败容器权限不足参考构建常见问题
编译构建 + 依赖校验同时失败且重跑无效多为闭源组件 patch 缺失或组件版本未发布PR !2537/!2442(补充闭源组件 patch)

处理建议

  1. 先判断是否环境抖动:评论 /retest 重跑一次,连续两次以上相同失败才按代码/配置问题排查。
  2. 命中制品缺失特征(见制品缺失)时,先修制品/版本,不要改构建代码。
  3. 属于配置错误时,用本地 bingo build 复现修复后再推送;涉及多单板的配置改动,至少本地验证失败过的单板目标。

门禁失败 ​

指非构建类检查任务失败,以及机器人标签阻塞合入。特点是重跑无效(/retest 不会改变检查结论),必须整改 PR 本身。

现象(如何被发现)

  • CI 结果表中「PR描述检查」「pre-commit检查」「修改行数检查」「防投毒检查」「开源合规检查」为 FAILED。
  • PR 被打上阻塞标签:needs-issue(未关联 Issue)、needs-squash(提交未压缩)、limit_1k_failed(变更超限)、unresolved-reviews(检视意见未处理)。
  • 机器人评论「当前PR有 N 条评论意见,其中 N 条未处理完毕」或「提交的PR需要关联issue」。

定位步骤

  1. PR 页读机器人评论,确认阻塞项:
    • 结果表哪个门禁任务 FAILED。
    • 标签区是否有 needs-issue / needs-squash / limit_1k_failed 等。
    • 「注意」评论提示的未处理检视意见数量。
  2. 门禁任务 FAILED 时,进入对应 Job 日志看具体命中项:
    • PR描述检查:日志逐字段列出 5 个必填字段的检查结果与字符数。
    • pre-commit检查:日志给出具体钩子(如 semgrep、格式化)命中的文件与规则。
    • 防投毒/开源合规:日志给出扫描命中的文件与规则说明。
  3. 检视意见类:在 PR 的 Changes/评论列表中逐条查看未 resolved 的意见。

判断依据

  • PR描述检查 FAILED => 描述为空,或 5 个模板字段任一缺失/不足 10 个字符。这是门禁类最高频问题(如 PR !2290 连续多次失败、PR !2491 补全描述后通过)。
  • pre-commit检查 FAILED => 格式不符或 semgrep 敏感信息命中(IP、账号、内部标识等)。
  • 修改行数检查 FAILED => 变更超过 1000 行且未获超大变更许可,PR 会被打 limit_1k_failed 标签;代码更新后机器人会移除 limit_1k_suc 重新检查。
  • 防投毒检查 FAILED => 引入新仓库/新依赖触发恶意代码扫描(如 PR !2203 集成新仓库 web_sol)。
  • 开源合规检查 FAILED => LICENSE 或源码版权头不合规(如 PR !2521;社区随后通过 PR !2528 统一 LICENSE 与版权声明治理)。
  • needs-issue 标签 => 未按格式关联 Issue(最高频的合入阻塞项)。
  • needs-squash 标签 => 存在多个待压缩提交或未按社区提交规范。

处理建议

  1. PR描述检查:按模板补全 5 个字段,每字段不少于 10 个字符,保存后评论 /retest(描述检查随 CI 重跑)。
  2. pre-commit:本地 pre-commit run --all-files 全量自检,修复格式与敏感信息命中(密钥/账号先移除或脱敏,确属误报再向 SIG 反馈)。
  3. 修改行数超限:拆分 PR;确需大变更时按超大变更流程申请,通过后获得 limit_1k_suc。
  4. 防投毒/开源合规误报:在 PR 中说明命中内容用途,联系 sig-release-management 复核;真正的合规问题按 PR !2528 的治理方式整改(木兰 PSL v2 LICENSE、标准版权头)。
  5. needs-issue:按指导关联 Issue(PR 描述 fixes #编号 或页面关联功能),完成后评论 /check-issue 移除标签。
  6. needs-squash:压缩/整理提交后推送,机器人自动复查。
  7. 检视意见全部处理完(含回复或解决)后评论 /check-pr,通过后机器人移除阻塞标签。

推送前本地自检清单(门禁失败重跑无效,推送前提前规避):

  1. pre-commit run --all-files 全量通过:修复格式问题与 semgrep 敏感信息命中(密钥/账号先移除或脱敏)。
  2. 自查变更行数:默认不超过 1000 行,超出先拆分 PR;确需大变更按超大变更流程申请。
  3. 按模板写全 PR 描述 5 个字段(功能描述/修改方案/验证方案/测试建议/自验证报告),每字段不少于 10 个字符。
  4. 按 fixes #编号 格式关联 Issue,或使用页面关联功能。
  5. 整理提交:压缩零散提交、遵守社区提交规范,避免 needs-squash。

制品缺失 ​

构建/依赖校验失败的最高频根因类别:manifest 引用的组件制品在 conan 仓中不存在、版本未发布,或制品内容已更新但锁定信息(revision/哈希)未同步。

现象(如何被发现)

  • 「编译构建」与「依赖校验」同时失败,常见多单板全红;典型触发者是「升级组件版本号」类 PR(如 PR !2488 升级 libsoc_adapter/general_hardware、PR !2496 升级 vpd、PR !2306 升级 devmon 等,均在 CI 中构建+依赖校验失败)。
  • 日志含 was not found in remote '<远端名>'(远端名为 openubmc_opensource,较早的 Conan 1.x 环境与 CI 镜像中为 openubmc_dev,以日志实际输出为准)。
  • 日志含 recipe revision 不匹配、SDK 锁定哈希校验失败。
  • 日志含 checkout ... returned non-zero exit status 128, reference is not a tree。

定位步骤

  1. 进入失败的「编译构建」或「依赖校验」Job 日志,确认报错组件名与版本号。
  2. 确认制品是否已发布:conan search '组件名/*' -r <远端名> 查看远端已发布版本清单,核对目标版本是否存在。远端名以本地 conan remote list 输出为准:init.py 初始化的当前环境为 openubmc_opensource,较早的 Conan 1.x 环境为 openubmc_dev,两者均为社区制品仓(conan.openubmc.cn),排查方法相同。
  3. 版本存在仍失败时,核对锁定文件(build/sdk/openubmc_sdk.lock)中该组件的 revision/哈希与远端实际制品是否一致(版本号相同但 revision 不同即命中本类问题)。
  4. 报 reference is not a tree 时,排查组件发布后源码仓是否被强推或删除过提交。

判断依据

  • 目标版本不在 conan search 结果中 => 版本未发布(常见于组件仓 PR 刚合入、制品尚未发布就先提了 manifest 升级 PR)。
  • 版本存在但 revision/哈希与 lock 文件不一致 => 组件同版本重发布后 manifest 未同步(如 PR !1877:storage 版本号不变、recipe revision 从 3ac2b2db 更新为 72038784;PR !2184:firmware_mgmt 包哈希更新)。
  • reference is not a tree => 组件发布后 git 提交树被变更(强推/删提交)。
  • 闭源组件触发源码构建(ERROR in xx Method 类报错)=> 闭源制品缺失/本地环境不配套,CI 场景多为闭源组件 patch 未同步(PR !2537/!2442 即为此类)。

处理建议

  1. 版本未发布:先到组件仓完成制品发布(PR 合入前评论 /publish,见怎么推包),确认 conan search 可见后再更新 manifest 升级 PR,必要时 /retest。
  2. revision/哈希不一致:同步更新 lock 文件中对应组件的 revision/包哈希(保持版本号不变),参考 PR !1877、!2184、!1855 的做法。
  3. git 树被变更:遵守社区规范——版本发布后不得修改 git 信息树;已发生变更的需重新发布组件版本。
  4. 闭源组件问题:按社区指导补齐闭源组件 patch/环境(CI 侧提 patch PR,本地侧参考构建常见问题中 bmc_sdk 配套说明)。
  5. 预防:升级组件版本的 PR 在描述中注明组件仓发布 PR/制品链接,便于评审与 CI 失败时快速核对。

权限异常(流水线侧) ​

典型日志特征

  • 日志出现 Username for 'https://...' 交互提示后卡住,或 git 拉取报 403。
  • 日志出现 permission denied / connect to the Docker daemon socket。
  • mount 相关步骤持续失败。
  • 整包构建长时间无输出,日志(task.log)显示停在 conan 认证等待输入。
  • CI 容器内 sudo 相关命令失败。

判断与处理

  • CI 内 conan 凭证由流水线 secrets 注入(CONAN_R_USER/PASSWORD),个人无感知;同样命令本地执行失败时,优先怀疑本地凭证配置(见场景二·权限异常)。
  • CI 内 sudo 失败 => 容器内非 root 提权受限(PR !1801 即为消除 qemu 构建流程中不必要的 sudo 操作);处理方向是重构构建脚本消除对提权的依赖,而非申请放开权限。
  • 其余 403 / Username for / mount / docker 权限特征与本地同源,识别与修复方法见场景二·权限异常。

怎么推包 ​

构建与制品类问题的通用修复路径:让 manifest 引用的制品先于升级 PR 存在。

  1. 组件仓发布:组件开发完成、本地 bingo build 验证通过后,在组件仓 PR 合入前评论 /publish(任何人可评论):PR 合入后机器人自动执行组件编译构建并发布到 conan 中心仓,同时将构建源码打 tag 发布到 GitCode 平台。漏评论 /publish 或发布失败时,联系组件仓 maintainer 手动发布。
  2. 核对制品可见:conan search '组件名/*' -r <远端名> 确认目标版本已出现在远端清单中(远端名说明见制品缺失定位步骤)。
  3. 更新 manifest:
    • 新版本:更新 manifest 中组件版本号。
    • 同版本重发布:保持版本号不变,同步更新 lock 文件中的 revision/包哈希(参考 PR !1877、!2184、!1855 的做法)。
  4. 重跑验证:推送后在 PR 下评论 /retest,确认「编译构建」「依赖校验」转绿。
  5. 规范:
    • 版本发布后不得修改 git 信息树(强推/删提交会触发 reference is not a tree),已变更需重新发布版本。
    • 升级组件版本的 PR 在描述中注明组件仓发布 PR/制品链接,便于评审与 CI 失败时快速核对。

场景二:本地构建 ​

本地执行 bingo build / bingo analysis / bingo test 失败时的定位方法。本地失败与 CI 失败的根因高度重叠(构建失败、制品缺失、权限异常两边通用),本地特有的差异集中在环境问题。因此本地定位的第一步是分清「环境问题」还是「代码/制品问题」,再分流到对应类别。

定位路径:从现象到原因 ​

  1. 确认环境基线(本地失败优先怀疑环境):
    • 执行环境:WSL(推荐)还是原生 Linux 等其他环境;是否已在 manifest 仓执行过 python3 init.py 完成初始化。
    • 工具版本:bingo --version 是否为最新(老版本存在 mount 权限、认证静默等待等已知问题)。
    • SDK 配套:本地 ~/sdk、~/rtos_compiler(bmc_sdk)与所构建的 manifest 版本是否配套;切换版本构建时须换用对应版本 bmc_sdk 重新初始化。
  2. 取完整日志:查看终端输出与 temp/log/task.log(与 CI 同源)。本地可查看全量日志,比 CI 自动带出的尾部 1000 行信息更全。
  3. 搜索错误特征:使用与场景一·构建失败定位步骤第 2 步相同的关键字列表。
  4. 按特征分流:按下文各节分组表比对错误特征,跳转对应处理;若 bingo 失败输出中已附带处理提示,优先按提示处理。

与 CI 结果交叉对照 ​

本地与 CI 结果放在一起看,可以快速分界问题归属:

组合大概率归属动作
本地失败,CI 通过本地环境/缓存问题(SDK 配套、凭证、资源)按环境问题排查,无需改代码
本地通过,CI 失败CI 环境抖动或 CI 镜像问题评论 /retest 重跑;连续两次同错再按构建失败排查
两边都失败代码/配置/制品问题按场景一构建失败、制品缺失定位;本地日志更全,优先本地复现修复后推送

环境问题(本地) ​

以下案例整理自构建常见问题及社区常见构建报错。本地环境问题与流水线的触发失败相对应:流水线「跑不起来」看触发,本地「跑不起来」看环境。

环境与工具

日志错误特征根因处理/去向
bingo: command not found、conan 未安装环境未初始化开发环境初始化
CMAKE_C_COMPILER not set, after EnableLanguage环境未初始化(缺交叉编译工具链)在 manifest 仓执行 python3 init.py 或 bingo build -t install_sdk
cannot import name 'decode_text' from 'conans.util.files'conan 安装损坏(卸载不彻底)pip3 uninstall conan 后重新 pip3 install conan
No remote ... defined in remote未配置 conan 远端conan 仓使用指导,远端名见制品缺失定位步骤
构建卡住、日志停在 conan 认证等待conan 凭证失效未提示(老版本 bingo)权限异常(本地)
KeyError: 'pwd'bingo test 缺 -jit 选项,或 manifest 与 bmc_sdk 版本不配套加 -jit 重试;核对 SDK 配套
自签名找不到 uboot 文件、Error in source() method、闭源组件 ERROR in xx Method本地 bmc_sdk 与依赖版本不配套按官网对应版本 bmc_sdk 替换 ~/sdk、~/rtos_compiler,见构建常见问题
Couldn't checkout ... git(非 reference is not a tree)本机 git 令牌缺失配置 git 凭证,见权限异常(本地)
Permission denied(文件操作)Linux 文件/用户权限不足检查出错文件属主与当前用户权限

资源与网络

日志错误特征根因处理/去向
internal compiler error: Killed构建环境内存不足内存不足解决说明;WSL 可调大 .wslconfig 的 memory=,磁盘充裕建议优先扩充物理内存
拉取源码、访问 conan 远端超时网络受限,未配置代理在 WSL 终端配置 http_proxy / https_proxy 环境变量,见开发环境初始化
配置代理后仍报 Could not resolve hostWSL 的 DNS 解析异常修改 /etc/resolv.conf 为可用 DNS,见开发环境初始化
mount 阶段卡住失败、connect to the Docker daemon socketbingo 构建镜像缺少特权 / 用户不在 docker 组权限异常(本地)
build.py 报 FileNotFoundError 找不到 SDK 文件-s 传入相对路径改用 SDK 压缩包绝对路径

构建失败(本地) ​

manifest 与依赖配置

日志错误特征根因处理
Version conflict: Conflict between ... and ...依赖组件版本冲突版本级构建查 temp/log/task.log 找到冲突组件修复;组件构建按控制台输出修复
组件没有在manifest中配置manifest 缺少依赖组件配置在对应单板 manifest 中配置依赖组件
Duplicated requirement: ...manifest.yml 配置了重复组件删除重复配置

代码与配置

日志错误特征根因处理
CMake Error、组件编译报错等其余错误代码/配置问题对照场景一构建失败典型场景表,本地直接复现修复后推送

制品缺失(本地) ​

日志错误特征根因处理
was not found in remote、Unable to find ... in remotes组件制品未发布与 CI 同理,见场景一制品缺失与怎么推包
revision/包哈希不匹配、reference is not a tree同版本重发布未同步 / git 树被变更见怎么推包
下载组件构建配方(recipe)失败,退出码 1本地 conan 缓存被清组件仓重新 bingo build,见构建常见问题

权限异常(本地) ​

现象根因处理
git 拉取提示 Username for 或 403https 访问未配置凭证创建 GitCode 私人令牌,配置 ~/.git-credentials 与 credential.helper store
构建卡在 conan 认证等待凭证失效未提示(老版本 bingo)升级最新 bingo(失效时会提示重新登录);老版本进入 task.log 按提示输入账号密码
permission denied ... docker daemon socket当前用户不在 docker 组sudo usermod -aG docker $USER 后重新登录生效
mount 阶段失败bingo 构建镜像缺少特权(旧版 bingo 权限逻辑)docker run 加 --privileged=true,并升级 bingo 至最新版

详细操作步骤见构建常见问题。

处理建议 ​

  1. 环境问题:升级最新 bingo;SDK 不配套时按官网对应版本 bmc_sdk 替换本地 ~/sdk、~/rtos_compiler,或重新执行 python3 init.py / bingo build -t install_sdk。
  2. 缓存问题:清理本地 conan 缓存后重试(Conan 1.x:rm -rf ~/.conan/data;Conan 2.x:conan remove "*" -c 或 rm -rf ~/.conan2/p/*),仍失败则重跑环境初始化。
  3. 制品问题:同场景一怎么推包——先发布组件制品,再更新 manifest 升级 PR。
  4. 自查无果再求助:附上「执行的完整命令、bingo 版本、环境形态(WSL/Linux 发行版等)、temp/log/task.log 尾部日志」四要素,到社区论坛或对应 SIG 提问,可显著缩短往返。

附录:机器人命令与标签速查 ​

常用命令(在 PR 下评论) ​

命令作用
/retest重跑流水线(触发失败、环境抖动、描述修改后使用)
/check-pr检查检视意见是否全部处理完毕
/check-issue已关联 Issue 但 needs-issue 标签仍在时移除标签
/publish在组件仓 PR 合入前评论,合入后自动构建组件并发布制品到 conan 中心仓(同时打 tag)
/ai review触发 AI 代码审查
/lgtm审核通过标签(需审核者权限)
/approve批准标签(需批准者权限),与 /lgtm 齐备后机器人自动合并

命令详细说明见机器人使用手册(PR 欢迎评论中的链接)。

常见标签 ​

标签含义解除方式
needs-issue未关联 Issue关联 Issue 后评论 /check-issue
needs-squash提交需压缩/整理整理提交后推送
limit_1k_failed变更超过 1000 行未通过拆分变更或走超大变更流程
limit_1k_suc超千行变更已获通过(代码更新后自动移除重新检查)保持
unresolved-reviews存在未处理检视意见处理完意见后评论 /check-pr
lgtm / approved审核通过/批准齐备后自动合并

本地复现常用命令 ​

以下命令的前提是已完成构建环境初始化:克隆 manifest 仓并在其目录下执行 python3 init.py -user <用户名> -psw <密码>(自动安装 bingo、配置 conan 远端与凭证),完整流程参考开发环境初始化。遇到命令不存在、认证失败等环境类报错,请参考构建常见问题。

bash
# 主产品构建(与 CI 编译构建 Job 一致)
bingo build -b openUBMC -bt debug

# 依赖解析(与 CI 依赖校验 Job 一致)
bingo analysis --rebuild

# 查询远端已发布组件版本(制品核对;远端名以 conan remote list 为准,
# init.py 初始化的当前环境为 openubmc_opensource,较早环境为 openubmc_dev)
conan search '组件名/*' -r openubmc_opensource

# CI 构建失败时自动打印的日志文件
tail -n 1000 temp/log/task.log