1. 为什么你的Addressable资源加载总是报InvalidKeyException?
最近在项目里用Unity的Addressable系统时,遇到了一个特别诡异的问题。明明资源路径写对了,Group配置也没问题,但就是报InvalidKeyException。折腾了大半天才发现,原来问题出在文件夹命名上。这个坑我踩过,相信不少开发者也会遇到。
Addressable系统虽然强大,但在资源加载路径处理上有些"洁癖"。当文件夹名称是资源文件名的子集时(比如文件夹叫"TestA",里面有个资源叫"TestA_001.png"),系统就会犯迷糊。我实测发现,这种情况下用"TestA/TestA_001.png"加载必定报错,但改成"TestB/TestA_001.png"就正常了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 文件夹命名与资源加载的隐藏规则
2.1 子集命名的致命陷阱
Addressable对路径解析有个隐藏逻辑:它会优先匹配最长的有效键名。当文件夹名是资源名的子串时,系统可能会错误地将文件夹名识别为资源名的一部分。比如:
csharp复制// 这样会报错
Addressables.LoadAssetAsync<Sprite>("TestA/TestA_001.png");
// 这样正常
Addressables.LoadAssetAsync<Sprite>("TestB/TestA_001.png");
经过多次测试,我发现只要文件夹名不是资源名的严格前缀就能避免这个问题。比如:
- "TestA_" + "TestA_001.png" → 报错
- "TestA1" + "TestA_001.png" → 正常
- "TestA/" + "TestA_001.png" → 报错
2.2 别名使用的注意事项
另一个坑是Addressable的别名功能。给文件夹设置别名时,如果别名和原始文件夹名大小写不一致,也会导致加载失败。例如:
csharp复制// 文件夹名:testRes
// 别名:TestRes
// 这样会报错
Addressables.LoadAssetAsync<Sprite>("TestRes/xx.png");
// 这样正常
Addressables.LoadAssetAsync<Sprite>
