初始化常见问题与排查 ​

在执行 python3 init.py -path /home/workspace/bmc_sdk_26.03.zip 时，可能会遇到以下失败场景。请根据错误信息对照排查。

环境检查失败 ​

网络相关失败 ​

初始化过程需要访问多个在线资源（华为云apt源、npm 淘宝镜像、openUBMC 仓库等），网络不通或网络传递慢是最常见的失败或超时的原因。

症状：apt-get update、wget、pip install、npm install 等命令超时或返回连接错误。

排查步骤：

1. 参照《环境准备简介》中"网络配置"章节，逐一检测各资源站的连通性。
2. 检查代理配置：脚本会检测 https_proxy 环境变量，如果配置了不需要的代理，请在初始化前执行：
   shell

   unset https_proxy && unset HTTPS_PROXY

3. 如果在公司内网环境，请确认防火墙放行了《环境准备简介》中"网络配置"章节列出的域名。
4. 如果使用 Docker 环境，检查 Docker 网络模式是否正确配置。
5. 如果你访问的软件源慢，建议配置包管理器加速源，可以参考 华为云、阿里云，以及其它云厂商或各大学提供的加速源。

APT 源配置失败 ​

症状：执行 apt-get update 报 GPG 错误、仓库无法访问，或 bingo/qemu 包下载失败并提示"请检查apt源是否配置成功"。

排查步骤：

1. 检查 /etc/apt/sources.list.d/ubuntu.sources 文件是否存在且内容正确。
2. 检查 GPG 密钥是否导入成功：
   shell

   gpg --list-keys BF3B2D407FDEDEA0DC91CC9412640FBCB175287A

3. 如果密钥服务器 keyserver.ubuntu.com 无法访问，可以手动导入密钥或联系管理员开放访问。
4. 检查 openUBMC APT 源文件：
   shell

   cat /etc/apt/sources.list.d/openubmc.list

   正确内容应包含 openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com 地址。

Conan 登录失败 ​

症状：conan remote login 命令返回认证错误。

排查步骤：

1. 确认已注册 openUBMC 社区账号，且用户名和密码正确。
2. 如果密码包含特殊字符，建议使用交互式输入（不传 -user 和 -psw 参数），避免 shell 转义问题。
3. 确认网络可以访问 conan.openubmc.cn。
4. 如果之前配置过 conan，可以尝试清除配置后重试：
   shell

   rm -rf ~/.conan2

BMC SDK 解压或安装失败 ​

症状：unzip 报错，或 SDK 文件解压不完整，或提示 安装 sdk 失败。

排查步骤：

1. 确认 bmcsdk 文件下载完整，检查文件大小是否正常。
2. 确认 bmcsdk 版本与 manifest 代码版本一致（如 26.03）。
3. 确认文件路径正确，建议使用绝对路径。
4. 如果之前已有安装残留，手动清理后重试：
   shell

   rm -rf ~/rtos_compiler ~/sdk ~/oee_compiler ~/oee_sdk

Node.js 安装失败 ​

症状：n 20.18.0 或 npm install 报错。

排查步骤：

1. 确认可以访问 registry.npmmirror.com。
2. 如果之前已安装 Node.js 其他版本，尝试先卸载旧版本：
   shell

   sudo apt remove -y nodejs npm

3. 检查磁盘空间是否充足：df -h。

PATH 环境变量未包含 ~/.local/bin ​

症状：初始化完成后执行 conan、n 等命令提示 command not found，但初始化过程未报错。

原因：部分工具（如 conan、Node.js 版本管理器 n）安装到 ~/.local/bin 目录，该目录不在系统默认 PATH 中。

解决方案：

手动将 ~/.local/bin 加入 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

添加后可通过 which conan 或 which n 验证命令是否可正常访问。

权限不足 ​

症状：Permission denied 或写入 /usr/bin、/etc/apt/ 等目录失败。

排查步骤：

1. 确认当前用户是 root 身份，且是直接root登录或使用su root登录。
2. 如果使用非 root 用户，初始化完成后需要手动配置环境变量，请参考上方"PATH 环境变量未包含 ~/.local/bin"章节。

命令超时 ​

症状：某个步骤长时间无响应后报 TimeoutExpired 或命令执行超过 600 秒自动终止。

排查步骤：

1. 通常是网络问题导致下载过慢，检查网络连接速度。
2. 开启详细日志定位具体卡在哪个命令：LOG=debug python3 init.py -path /home/workspace/bmc_sdk_26.03.zip。
3. 如果是特定包下载缓慢，可考虑配置系统级代理加速。