构建管线错误码
在构建管线失败后会输出错误码,帮助我们排查问题原因。
下面是对默认构建管线的输出错误码的说明。
TaskPrepare节点
-
ErrorCode100
构建管线正在执行中,同一时刻只允许一个构建任务进行。
-
ErrorCode101
当前打开的场景并未保存,构建管线需要确保所有资产保存完毕。
-
ErrorCode110
构建参数里没有填写构建的目标平台,BuildTarget参数不能为空!
-
ErrorCode111
构建参数里填写的包裹名称为空。PackageName参数不能为空!
-
ErrorCode112
构建参数里填写的资源版本为空。PackageVersion参数不能为空!
-
ErrorCode113
构建参数里填写的构建输出目录为空。BuildOutputRoot参数不能为空!
-
ErrorCode114
构建参数里填写的内置文件目录为空。BuildinFileRoot参数不能为空!
-
ErrorCode115
构建输出的包裹目录已经存在。该问题通常是由于增量构建下,当前构建的资源版本和之前构建的资源版本冲突导致的。
可以修改PackageVersion解决该问题。
-
ErrorCode116
构建参数里填写的构建管线名称为空。BuildPipeline参数不能为空!
-
ErrorCode117
构建参数里填写的构建资源包类型无效。BuildBundleType参数不能为空!
-
ErrorCode130
该错误码为警告,提示开发者在使用Unity2021版本及后续版本的时候,推荐使用SBP构建管线!
随着Unity引擎版本的迭代,Unity2021版本及后续版本对内置构建管线的兼容不足,会导致在构建场景或其它资源的时候出现莫名其妙的显示问题。
TaskGetBuildMap节点
-
ErrorCode200
该错误码为警告,提示开发者非主资源收集器(MainAssetCollector)配置的资源标签无效。
可以修改资源配置文件移除收集器的Tags信息来解决该问题。
-
ErrorCode201
该错误码为警告,提示开发者资源收集器内存在零依赖资产,构建管线会自动剔除该资产避免包体冗余。
该警告只是提示作用,不会对构建结果造成任何负面影响。开发者可以把零依赖资产删除或者忽视该警告。
-
ErrorCode202
构建管线内没有发现任何需要打包的资产,重点检查资源配置是否完整。
-
ErrorCode210
原生文件构建管线,构建的资源包只能包含一个原生文件。
重点检查资源配置的收集器打包规则。原生文件打包规则需要配置为:PackRawFile
TaskBuilding节点
-
ErrorCode300
Unity引擎构建AssetBundle资源包失败。需要重点看下引擎提示的错误或警告日志。
开发者可以根据引擎输出的日志去解决打包失败问题,大多数在Google上都可以找到答案!
-
ErrorCode301
内置构建管线输出的清单文件不存在。
极为特殊情况下会触发该错误,可以在社区群联系开源作者。
TaskUpdateBundleInfo节点
-
ErrorCode400
检测到Bundle名称长度超过了260个字符。
操作系统的文件系统对资源路径的长度有限制,资源文件名称太长会导致加载失败。
可以尝试降低Bundle名称长度来解决该问题。
-
ErrorCode401
在Unity引擎构建的清单内,未找到某个资源的Hash数据。
-
ErrorCode402
在Unity引擎构建的清单内,未找到某个资源的CRC数据。
-
ErrorCode403
虚拟资源包里的资源列表为空,导致计算资源包大小为零。
TaskVerifyBuildResult节点
-
ErrorCode500
该错误码为警告,提示差异项的资源包名称。
-
ErrorCode501
检测到Unity引擎构建的资源包列表和开发者的配置不一致。
结合错误码500的警告信息来排查问题原因。
TaskCreateManifest节点
-
ErrorCode600
可编程构建管线里,未找到查询依赖的资源包。
极为特殊情况下会触发该错误,可以在社区群联系开源作者。
-
ErrorCode601
该错误码为警告,提示构建管线构建的资源包里存在游离资源包。
可编程构建管线会自动剔除一些引擎内置资产的引用关系,这样资产的依赖关系发生了变化,会导致和预期不一致,从而产品游离资源包。
该问题目前不会造成严重影响,会造成CDN服务器里存储一些任何时刻使用不到的资源包文件。
-
ErrorCode602
资源清单内的资源文件的哈希值冲突。
-
通常发生在原生文件构建管线。
当原生文件构建管线里存在任意俩个相同的文件,就导致资源清单里记录的资源包文件哈希值冲突。
通常原生文件里不应该存在二进制完全相同的文件,可以删除其中一个解决该问题。
-
一些加密算法在加密资源包文件后,有极小的概率发生哈希冲突。
开发者可以优化或修改加密算法,来规避该问题。
-