Unity Mod加载UI Toolkit AssetBundle失败：无法读取归档文件头求助

问题背景 #

为一款支持Mod的视频游戏开发Mod，计划将现有IMGUI实现的UI替换为Unity标准UI。按照官方流程完成了Runtime UI制作与AssetBundle构建，清单显示资源已正确打包，但在游戏内加载时出现以下错误：

Unable to read header from archive file: C:/Test/CustomAsset/customui.assets
Failed to read data for the AssetBundle

测试加载代码如下：

var bundleLoadRequest = AssetBundle.LoadFromFile(
            Path.Combine("C:\\Test\\CustomAsset", "customui.assets")); 
        Log(bundleLoadRequest.GetAllAssetNames().ToString());

已确认路径有效（错误路径会触发“无法定位资源”提示），寻求解决方向。

解决方向 #

• 匹配Unity版本兼容性：确保构建AssetBundle使用的Unity版本与目标游戏的Unity版本完全一致（包括次要版本号）。Unity的AssetBundle格式随版本迭代有变更，跨版本构建的Bundle会出现头文件无法识别的问题。
• 验证Bundle文件有效性：在构建AssetBundle的Unity编辑器中，尝试直接加载该Bundle文件，确认是否能正常读取资源。如果编辑器内也无法加载，说明构建过程中存在文件损坏或配置错误，需检查构建脚本的日志输出。
• 核对Bundle文件名与构建配置：检查构建脚本中指定的Bundle名称是否为customui.assets。部分构建流程会自动添加.bundle后缀，或可能误将生成的辅助.assets文件当成了目标Bundle（实际Bundle是你指定名称的那个文件，清单文件是额外生成的）。
• 排查文件权限与路径格式：确保游戏进程拥有目标文件的读取权限，避免将Bundle放在系统保护目录（如Program Files）。同时尝试将路径中的反斜杠\\替换为正斜杠/，避免转义字符潜在问题。
• 优化加载逻辑捕获详细错误：改用异步加载并优先检查错误信息，避免直接调用GetAllAssetNames()导致未处理的加载失败：

var bundleLoadRequest = AssetBundle.LoadFromFileAsync(Path.Combine("C:/Test/CustomAsset", "customui.assets"));
yield return bundleLoadRequest;

if (!string.IsNullOrEmpty(bundleLoadRequest.error))
{
    Log($"AssetBundle加载错误详情: {bundleLoadRequest.error}");
    return;
}

var targetBundle = bundleLoadRequest.assetBundle;
if (targetBundle != null)
{
    Log($"已加载资源列表: {string.Join(", ", targetBundle.GetAllAssetNames())}");
}

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