U-Boot 2013.07 編譯避坑實錄：交叉工具鏈不一致導致段錯誤

現象描述

編譯 U-Boot 2013.07 時，鏈接階段報錯：

/bin/bash: line 1:  8974 段錯誤 (core dumped)
make: *** [u-boot] Error 139

Error 139 = `SIGSEGV` (段錯誤)，通常意味著**編譯器/鏈接器自身崩潰**，而非代碼邏輯錯誤。

根因分析：工具鏈污染

1. 嘗試過多種編譯命令（`make`、`make CROSS_COMPILE=...`、`gnu-linux-gcc` 等）
2. 不同命令隱式使用不同交叉編譯器前綴（`arm-none-linux-gnueabi-` vs `arm-unknown-linux-gnueabi-`）
3. 產生的中間文件 (`.o`、`.d`、配置文件) 混雜了不同工具鏈的 ABI/指令集/庫版本
4. 鏈接時 `ld` 讀取混雜目標文件，內部邏輯錯誤導致段錯誤

解決方案：乾淨重建

# 1. 徹底清理 (關鍵！)
make distclean      # 或 rm -rf 源碼目錄重新解壓

# 2. 確認工具鏈環境變量唯一
export CROSS_COMPILE=arm-unknown-linux-gnueabi-
# 驗證
${CROSS_COMPILE}gcc --version

# 3. 單一配置編譯
make smdk2410_defconfig  # 或你的具體板級配置
make -j$(nproc)

最佳實踐：標準化編譯腳本

#!/bin/bash
# build_uboot.sh
set -euo pipefail

BOARD_CONFIG="smdk2410_defconfig"
CROSS_COMPILER="arm-unknown-linux-gnueabi-"
UBOOT_DIR="u-boot-2013.07"

# 進入目錄
cd "${UBOOT_DIR}"

# 乾淨構建
echo "=== Cleaning ==="
make distclean

echo "=== Configuring: ${BOARD_CONFIG} ==="
make "${BOARD_CONFIG}"

echo "=== Building with ${CROSS_COMPILER} ==="
make CROSS_COMPILE="${CROSS_COMPILER}" -j$(nproc)

echo "=== Done: u-boot.bin ==="
ls -lh u-boot.bin

常見交叉編譯器前綴對照

鐵律：**全專案統一前綴**，包括內核、U-Boot、文件系統、應用程序。混用 = 災難。

進階排查：若乾淨重建仍失敗

1. 編譯器版本過舊/過新：U-Boot 2013 需 GCC 4.7~6.x，GCC 10+ 可能因默認 `-fno-common` 等導致錯誤。嘗試 `export CFLAGS="-fcommon"`
2. 鏈接腳本/啟動代碼不匹配：檢查 `arch/arm/cpu/arm920t/start.S`、`board/xxx/u-boot.lds`
3. 內存不足：鏈接需大量內存，虛擬機建議 ≥ 4GB RAM + Swap
4. 並行編譯衝突：嘗試 `make -j1` 排除競態
5. 源碼缺陷：檢查官方郵件列表/補丁，舊版本可能有已知 Bug

現代替代：Docker 固化構建環境

# Dockerfile.uboot-build
FROM ubuntu:20.04
RUN apt-get update && apt-get install -y \
    build-essential gcc-arm-linux-gnueabihf u-boot-tools \
    git make bc cpio gzip
WORKDIR /src
# 將源碼 COPY 進鏡像或掛載卷
# docker run --rm -v $(pwd):/src uboot-builder ./build_uboot.sh

**優勢**：環境不可變、可復現、CI/CD 直接複用、宿主機無污染。

核心教訓： 交叉編譯**環境一致性**是生命線。任何「試探性編譯」都會污染構建產物。**`make distclean` + 統一 `CROSS_COMPILE` + 單一配置** 是鐵律。現代項目請直接用 Docker 固化工具鏈，消除「在我機器上能跑」的玄學問題。