编译ImmortalWrt N1固件时依赖包缺失怎么办？

Question

在编译ImmortalWrt适配N1固件时，常遇到“依赖包缺失”问题，典型表现为`make defconfig`或`make`过程中提示“package not found”或“missing dependency”。这通常因源码分支切换不完整、feeds未更新或第三方软件源未正确加载所致。尤其在使用GitHub镜像或自定义插件时，若未执行`./scripts/feeds update -a && ./scripts/feeds install -a`，会导致opkg依赖解析失败。此外，部分开发者忽略Ubuntu/Debian系统基础依赖（如build-essential、libssl-dev、python3等），也会间接引发包管理异常。如何精准定位并补全这些依赖是成功编译的关键。

Answer 1

一、问题现象与典型错误输出

在编译 ImmortalWrt 适配 N1 固件时，开发者常遇到如下错误信息：

        WARNING: Makefile 'package/utils/busybox/Makefile' has a dependency on 'cryptd-mbedtls', which does not exist
        make defconfig failed, please check your config.
        package not found: kmod-usb-net-rtl8152
        missing dependency for luci-app-passwall: libopenssl
    

这些提示表明系统无法解析某些软件包的依赖关系。此类问题多出现在以下场景：

• 切换源码分支后未同步 feeds 源
• 使用 GitHub 镜像导致子模块拉取不完整
• 第三方插件（如 luci-app-openclash）未正确注册到 feeds
• 本地构建环境缺少基础开发工具链

二、依赖缺失的根本原因分析

从构建流程角度看，ImmortalWrt 使用 OpenWrt 的构建框架，其依赖管理分为两个层级：

1. 系统级依赖：即宿主操作系统所需的基础库和编译工具。
2. 项目级依赖：包括 feeds 源中的软件包及其 opkg 依赖树。

下表列出常见错误类型与对应成因：

错误表现	可能原因	影响范围
package not found in feed	feeds 未更新或插件路径错误	个别模块无法加载
missing dependency for libssl	libssl-dev 未安装或版本冲突	全局编译失败
scripts/feeds install fails silently	git 子模块权限或网络超时	feeds 数据不完整
make defconfig error due to unknown config	branch 切换后 .config 未清理	配置解析中断

三、系统级依赖检查与补全

在 Ubuntu/Debian 系统中，必须确保以下核心依赖已安装：

sudo apt update
sudo apt install -y build-essential clang flex bison gawk \
    gettext git libncurses5-dev libssl-dev python3 \
    zlib1g-dev swig unzip libelf-dev bash-completion
    

特别注意：

• python3 是 feeds 脚本运行所必需，部分旧教程仍推荐 python2，已过时。
• clang 支持现代 C 编译优化，尤其在启用 Kernel LTO 时至关重要。
• bash-completion 虽非强制，但可提升脚本调试效率。

四、feeds 源管理机制详解

ImmortalWrt 的软件包通过 feeds.conf.default 定义外部源，其标准结构如下：

src-git packages https://github.com/openwrt/packages.git;openwrt-23.05
src-git luci https://github.com/openwrt/luci.git;openwrt-23.05
src-git routing https://github.com/openwrt/routing.git;openwrt-23.05
src-git telephony https://github.com/openwrt/telephony.git;openwrt-23.05
# 自定义插件源示例
src-git small https://github.com/kenzok8/small.git
    

执行顺序极为关键：

./scripts/feeds clean
./scripts/feeds update -a
./scripts/feeds install -a
make defconfig
    

五、诊断与修复流程图

为快速定位依赖问题，建议遵循以下决策流程：

graph TD
            A[编译报错: package not found] --> B{是否首次编译?}
            B -- 是 --> C[检查系统依赖]
            B -- 否 --> D[是否切换过 branch?]
            D -- 是 --> E[执行 feeds clean && update -a]
            D -- 否 --> F[检查 feeds.conf 是否包含插件源]
            F --> G[运行 ./scripts/feeds install -a]
            G --> H[清理 .config 并 make defconfig]
            H --> I[重新 make V=s]
            C --> J[安装 build-essential libssl-dev python3]
            J --> G

六、高级调试技巧与日志分析

当常规方法无效时，可通过以下方式深入排查：

• 查看 tmp/.config-feeds 文件确认 feeds 解析结果。
• 使用 find package/ -name "Makefile" | xargs grep -l "kmod-usb-net-rtl8152" 定位包是否存在。
• 启用详细日志：make V=s -j1 单线程输出便于追踪。
• 检查 staging_dir/target*/stamp/ 目录判断依赖是否已构建。

此外，可编写自动化检测脚本：

#!/bin/bash
if ! dpkg -s build-essential libssl-dev python3 >/dev/null 2>&1; then
    echo "【错误】系统依赖缺失，请先安装"
    exit 1
fi

if [ ! -f ./scripts/feeds ]; then
    echo "【错误】源码不完整，请检查 git clone 是否带子模块"
    exit 1
fi

./scripts/feeds update -a && ./scripts/feeds install -a || {
    echo "【警告】feeds 加载失败，请检查网络或镜像可用性"
    exit 1
}