Yocto中使用BBCLASSEXTEND扩展nginx Recipe失败，求排查

开发者阿泽

2026-7-11

问题原因与解决方案

错误原因

BBCLASSEXTEND = "nginx" 用法错误：该变量用于继承Yocto的类文件（.bbclass），比如native、nativesdk这类通用类，但nginx是一个软件包Recipe，并非bbclass，因此bitbake找不到classes/nginx.bbclass文件，导致报错。

正确解决方案

方法一：使用.bbappend（Yocto规范推荐）

这种方式直接扩展nginx的原有Recipe，是修改软件包文件的标准做法：

在你的自定义meta层（meta-wmt）中创建路径：recipes-nginx/nginx
创建文件 nginx_%.bbappend，内容如下：

SRC_URI += "file://default_server"

do_install_append() {
    # 覆盖原有的default_server文件，确保权限正确
    install -m 0644 ${WORKDIR}/default_server ${D}/etc/nginx/sites-available/
}

将你修改后的default_server文件放入路径：meta-wmt/recipes-nginx/nginx/files/
重新编译nginx即可，编译时会自动追加该步骤替换目标文件。

方法二：修改自定义Recipe（适合独立包场景）

如果坚持使用独立Recipe，需删除错误的BBCLASSEXTEND配置，改为依赖nginx：

SUMMARY = "nginxconfig"
DESCRIPTION = "${SUMMARY}"
LICENSE = "CLOSED"
LIC_FILES_CHKSUM = "mychecksum"

S = "${WORKDIR}"

# 声明依赖nginx，确保安装顺序
DEPENDS += "nginx"
RDEPENDS_${PN} += "nginx"

SRC_URI = "file://default_server"

do_install() {
    install -d ${D}/etc/nginx/sites-available
    # 使用install而非cp，确保文件权限正确
    install -m 0644 ${WORKDIR}/default_server ${D}/etc/nginx/sites-available/
}

FILES_${PN} += "/etc/nginx/sites-available/*"