Yocto Kirkstone中REQUIRED_VERSION指定不存在版本未报错问题求助

云原生阿岚

2026-8-5

问题原因及解决办法

核心原因

REQUIRED_VERSION 的校验逻辑仅在目标版本的配方已被BitBake索引到时才会触发。如果指定的版本完全不存在于配方目录或layer的搜索路径中，BitBake根本找不到该版本的配方定义，此时版本校验逻辑不会执行，BitBake会自动 fallback 选择当前可用的最高版本或默认版本。

另外在Kirkstone版本中，REQUIRED_VERSION的校验是在配方解析完成后执行的，若指定版本的配方文件不存在，BitBake不会去解析它，自然也不会触发版本校验失败的报错逻辑。

验证与解决步骤

确认配方索引有效性
先检查配方文件命名是否严格遵循PN_PV.bb格式（比如my-recipe_1.0.0.bb），且存放路径在layer的BBFILES配置范围内。可以通过layer的conf/layer.conf确认：
```
BBFILES += "${LAYERDIR}/recipes-myrecipe/my-recipe/*.bb"
```
再用命令查看BitBake已索引的所有版本：
```
bitbake-layers show-recipes my-recipe
```

改用更严格的版本强制方案
要确保指定版本不存在时直接报错，可结合PREFERRED_VERSION和自定义校验逻辑：
在image.bb中添加：

PREFERRED_VERSION_my-recipe = "1.0.0"
REQUIRED_VERSION_my-recipe = "1.0.0"

python () {
    available_versions = d.getVar("BBVERSIONS_my-recipe", True) or ""
    if "1.0.0" not in available_versions.split():
        bb.fatal("Required version 1.0.0 of my-recipe is not available!")
}