前言 / 这是一个不断积累的文档！🪇

欢迎来到 Unity 报错集合与解决方案文档！在这里寻找 Unity 报错并了解相应的解决方案。

常见错误

此表格还需要更多补充和审查

解决方法处写有“网络问题”意味着你需要参考《VRChat 网络困境指南》。

原文	含义	解决方法
// TODO	网络同步的 VRC Expression 参数超过 256 bits	尝试删除一些需要同步参数的功能或预制件
// TODO	使用了超过 256个 PhysBone 组件
// TODO	使用了超过 256个 PhysBone Collider 组件
lllegal byte sequence encounted in the input.	构造托管string对象时，字节序列不是有效编码	主机名包含非ASCII字符，或工程文件夹及其路径包含非ASCII字符，修改为纯英文后重新上传
Error building Player because scripts had compiler errors	脚本编译失败，因为存在编译错误	工程文件夹及其路径包含非ASCII字符，修改为纯英文后重新上传
"Missing Credentials"	IP 变动导致登录会话失效	网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆
Unauthorized, try logging out and in again	未授权，请重新登录并重新尝试	网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆
Avatar validation failed	虚拟形象验证失败	请查看控制台寻找更多的报错以了解具体原因
Failed to build the Avatar	虚拟形象构建失败	请查看控制台寻找更多的报错以了解具体原因
Failed to upload avatar!	虚拟形象上传失败	网络问题
UploadException:Failed to upload file	上传文件失败	网络问题
Image upload failed:Failed to upload file.	上传图片封面失败	网络问题
Attempted to load the data for an avatar we do not own, clearing blueprint lD	无法加载不属于你的虚拟形象数据，正在清除蓝图 lD	只要初次上传失败就会有这个，请无视之
Could not fetch fresh config file. Using cached if available.	SDK 无法获得最新的在线配置更新	网络问题

其它错误

和构建上传 VRChat Avatar 无关但可能遇到的其它常见错误及其可能的解决办法：

此表格还需要更多补充和审查，此处填写常见的错误，可能不会出现在控制台或 VRCSDK 中

症状描述	解决办法
lilToon 材质检查器上的文本都消失了	使用 ALCOM 重装 lilToon

有搞不懂的问题？

如果您遇见了搞不懂的报错，您可以试着加入 QQ群聊 750258838 分享您的问题，群内的大佬会提供解答。

有想要分享的经验？

如果您有想要分享的报错或解决方法，您也可以选择成为一名 内容作者，内容作者可以直接编辑此文档。

您还可以在下方评论区留言，分享您的见解与看法。