前言 / 目录

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

查看你的SDK控制面板，红色框中的内容标志着模型在什么环节出现了问题，橙色框中的内容是出错有关的“详细信息”。

为了将你的资产打包发送到 VRC 服务器，SDK 会走过三个流程：构建、验证、上传。

构建和验证被 SDK 统称为构建。

如果你的红色框文字显示为 Build Failed，这意味着世界/虚拟形象的构建或验证环节出现了问题，你需要再查看橙色框中的内容以确认具体是哪个环节出现了问题。

接下来要查看 Console（控制台）以寻找真正的错误原因。

Console 面板的右上角有白黄红三个标志，分别意味着信息，警告，错误。你只需要查看错误即可锁定自己的问题。

你需要在右上角分别点击信息和警告按钮一次，这会仅显示 错误日志，也就是所有“有用”的信息。

不了解报错的含义也没关系，我们准备了一个表格，用来帮助你更快地点对点纠错。

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

解决方法处写有“网络问题”意味着你需要参考《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// ~~变动导致登录会话失效~~TODO 缺少 Body 网格指定

原文	含义	解决方法
VRCExpressionParameters has too many parameters defined.	网络同步的 VRC Expression 参数超过 256 bits	尝试删除一些需要同步参数的功能或预制件
// TODO	使用了超过 256个 PhysBone 组件	尝试减少 PhysBone 组件的使用
// TODO	使用了超过 256个 PhysBone Collider 组件	尝试减少 PhysBone Collider 组件的使用

原文	含义	解决方法
UploadException:Failed to upload file	上传文件失败	网络问题
Image upload failed:Failed to upload file.	上传图片封面失败	网络问题
Could not fetch fresh config file. Using cached if available.	SDK 无法获得最新的在线配置更新	网络问题
"Missing Credentials"	IP 变动导致登录会话失效	网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆
Unauthorized, try logging out and in again	未授权，请重新登录并重新尝试	网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆
~~UploadException:Failed~~ ~~to upload file~~	~~上传文件失败~~// TODO mipmap streaming 什么的	~~网络问题~~

~~Image upload failed:Failed to upload file.~~原文	~~上传图片封面失败~~含义	~~网络问题~~解决方法
Attempted to load the data for an avatar we do not own, clearing blueprint lD	无法加载不属于你的虚拟形象数据，正在清除蓝图 lD	~~只要初次上传失败就会有这个，请无视之~~只要初次上传失败就会出现该日志，没有实际意义

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

TODO 完成该表格并进行审查，此处填写常见的错误，可能不会出现在控制台或 VRCSDK 中

症状描述	解决办法
~~Could~~lilToon ~~not fetch fresh config file. Using cached if available.~~材质检查器上的文本都消失了	~~SDK~~使用 ~~无法获得最新的在线配置更新~~ALCOM 重装 lilToon
Viseme 不工作	~~网络问题~~lipsync 混合形状没有全部指定，或任意 Playable Layer 控制器中有动画录制了 lipsync 混合形状

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

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

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




有想要分享的经验？
如果您有想要分享的报错或解决方法，您也可以选择成为一名 内容作者，内容作者可以直接编辑此文档。
您还可以在下方评论区留言，分享您的见解与看法。