iOS应用Bazel构建失败：MyLib更新后出现NoneType错误排查

使用Bazel构建iOS应用时，更新依赖库MyLib后构建失败，错误信息如下：

ERROR: /Projects/ios/MyLib/BUILD:10:33: in apple_dynamic_xcframework_import rule //ios/MyLib:MyLib: 
Traceback (most recent call last):
    File "/external/build_bazel_rules_apple/apple/internal/apple_xcframework_import.bzl", line 513, column 65, in _apple_dynamic_xcframework_import_impl
        cc_info = framework_import_support.cc_info_with_dependencies(
    File "/external/build_bazel_rules_apple/apple/internal/framework_import_support.bzl", line 90, column 68, in _cc_info_with_dependencies
        (compilation_context, _compilation_outputs) = cc_common.compile(
Error in compile: at index 20 of public_hdrs, got element of type NoneType, want File
ERROR: /Projects/ios/MyLib/BUILD:10:33: Analysis of target '//ios/MyLib:MyLib' failed
ERROR: Analysis of target '//ios:MyApp' failed; build aborted: 

MyLib为预构建动态框架，未显式定义导入头文件，更新后内部结构无新增文件，对应的BUILD规则如下：

apple_dynamic_xcframework_import(
            name = "MyLib",
            visibility = [
                "//visibility:public",
            ],
            xcframework_imports = glob(["MyLib.xcframework/**"]),
        )

需明确该错误的成因及调试方法。

1. glob匹配无效路径：glob(["MyLib.xcframework/**"]) 可能匹配到了不存在的文件路径，或是xcframework内的元文件被误识别为头文件，导致Bazel处理public_hdrs时获取到NoneType（无对应文件实体）。
2. xcframework元数据变更：即使文件结构无新增，更新后的MyLib可能修改了内部Info.plist或module.modulemap，导致Bazel解析头文件列表时指向了实际不存在的路径，触发空值错误。
3. 规则兼容性问题：当前使用的build_bazel_rules_apple版本与更新后的MyLib框架结构不兼容，规则在解析头文件时出现异常。

• 核查glob匹配结果：执行bazel query '//ios/MyLib:MyLib' --output=files，查看xcframework_imports实际匹配的文件列表，确认是否存在无效路径或非框架文件。若有，调整glob规则为更精确的匹配：

  xcframework_imports = glob([
      "MyLib.xcframework/**/*.framework",
      "MyLib.xcframework/**/*.dSYM",
      "MyLib.xcframework/Info.plist",
  ])
  

• 检查xcframework内部结构：手动打开MyLib.xcframework，确认各平台框架下的头文件均存在，且module.modulemap中的头文件路径无误。排查是否存在模块映射中声明了某个头文件，但实际文件已被移除的情况。
• 清除Bazel缓存：执行bazel clean --expunge清空所有缓存，重新构建，避免旧缓存引发的解析异常。
• 显式指定头文件：在apple_dynamic_xcframework_import中添加public_hdrs字段，明确指定头文件路径：

  apple_dynamic_xcframework_import(
      name = "MyLib",
      visibility = ["//visibility:public"],
      xcframework_imports = glob(["MyLib.xcframework/**"]),
      public_hdrs = glob(["MyLib.xcframework/**/*.h"]),
  )
  

• 验证规则版本兼容性：检查当前build_bazel_rules_apple版本是否适配该xcframework结构，尝试升级或回退规则版本，观察问题是否解决。

内容的提问来源于stack exchange，提问作者Vlad