前言 / 目录
欢迎来到 Unity 报错集合与解决方案文档！在这里寻找 Unity 报错并了解相应的解决方案。
如何识别 Unity 报错？
1、到底是哪里出了问题？
查看你的SDK控制面板，红色框中的内容标志着模型在什么环节出现了问题，橙色框中的内容是出错有关的“详细信息”。
为了将你的资产打包发送到 VRC 服务器，SDK 会走过三个流程：构建、验证、上传。
构建和验证被 SDK 统称为构建。
如果你的红色框文字显示为 Build Failed，这意味着世界/虚拟形象的构建或验证环节出现了问题，你需要再查看橙色框中的内容以确认具体是哪个环节出现了问题。
接下来要查看 Console（控制台） 以寻找真正的错误原因。
2、检查你的 Console（控制台）
Console 面板的右上角有白黄红三个标志，分别意味着 信息， 警告， 错误。你只需要查看 错误 即可锁定自己的问题。
你需要在右上角分别点击 信息 和 警告 按钮一次，这会仅显示 错误日志，也就是所有“有用”的信息。
不了解报错的含义也没关系，我们准备了一个表格，用来帮助你更快地点对点纠错。
常见错误
此表格还需要更多补充和审查
解决方法处写有“网络问题”意味着你需要参考《VRChat 网络困境指南》。
构建错误
|
原文 |
含义 |
解决方法 |
|
构造托管string对象时，字节序列不是有效编码 |
主机名包含非ASCII字符，或工程文件夹及其路径包含非ASCII字符，修改为纯英文后重新上传 |
|
|
Error building Player because scripts had compiler errors |
脚本编译失败，因为存在编译错误 |
工程文件夹及其路径包含非ASCII字符，修改为纯英文后重新上传 |
|
|
// TODO 缺少 Body 网格指定 |
|
验证错误
|
原文 |
含义 |
解决方法 |
|
VRCExpressionParameters has too many parameters defined. |
网络同步的 VRC Expression 参数超过 256 bits |
尝试删除一些需要同步参数的功能或预制件 |
|
// TODO |
使用了超过 256个 PhysBone 组件 |
尝试减少 PhysBone 组件的使用 |
|
// TODO |
使用了超过 256个 PhysBone Collider 组件 |
尝试减少 PhysBone Collider 组件的使用 |
上传失败
|
原文 |
含义 |
解决方法 |
|
上传文件失败 |
网络问题 |
|
|
上传图片封面失败 |
网络问题 |
|
|
Could not fetch fresh config file. Using cached if available. |
SDK 无法获得最新的在线配置更新 |
网络问题 |
|
"Missing Credentials" |
IP 变动导致登录会话失效 |
网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆 |
|
未授权，请重新登录并重新尝试 |
网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆 |
|
|
|
// TODO mipmap streaming 什么的 |
|
无关信息
|
原文 |
含义 |
解决方法 |
|
Attempted to load the data for an avatar we do not own, clearing blueprint lD |
无法加载不属于你的虚拟形象数据，正在清除蓝图 lD |
只要初次上传失败就会出现该日志，没有实际意义 |
其它错误
和构建上传 VRChat Avatar 无关的其它常见错误及其解决办法：
TODO 完成该表格并进行审查，此处填写常见的错误，可能不会出现在控制台或 VRCSDK 中
|
症状描述 |
解决办法 |
|
lilToon 材质检查器上的文本都消失了 |
使用 ALCOM 重装 lilToon |
|
Viseme 不工作 |
lipsync 混合形状没有全部指定，或任意 Playable Layer 控制器中有动画录制了 lipsync 混合形状 |
有搞不懂的问题？
如果您遇见了搞不懂的报错，您可以试着加入 QQ群聊 750258838 分享您的问题，群内的大佬会提供解答。
有想要分享的经验？
如果您有想要分享的报错或解决方法，您也可以选择成为一名 内容作者，内容作者可以直接编辑此文档。
您还可以在下方评论区留言，分享您的见解与看法。
No comments to display
No comments to display