此表格还需要更多补充和审查
解决方法处写有“网络问题”意味着你需要参考[**《VRChat 网络困境指南》**](https://docs.vrcd.org.cn/books/vrchat-oYE)。
#### 构建错误| **原文** | **含义** | **解决方法** |
| Please fix compile errors before creating new state machine behaviours | 请在创建新 StateBehaviour 前修复编译错误 | 工程存在脚本编译错误，需要修复 |
| Error while saving Prefab: '{}'. You are trying to save a Prefab with a missing script. This is not allowed. | Avatar 中包含缺失脚本的引用 | 使用 ALCOM 安装缺失的 VPM 包，一般是 Modular Avatar |
| [lllegal byte sequence encounted in the input.](https://docs.vrcd.org.cn/books/unity-unity/page/lllegal-byte-sequence-encounted-in-the-input-parameter-name-string) | 构造托管string对象时，字节序列不是有效编码主机名包含非 ASCII 字符。可能原因是主机名包含非 ASCII 字符，或工程文件夹及其路径包含非 ASCII 字符 | 将主机名和工程文件夹及其所在路径重命名为纯英文后重新上传 |
| [Error building Player because scripts had compiler errors.](https://docs.vrcd.org.cn/books/unity-unity/page/error-building-player-because-scripts-had-compiler-errors) | 脚本编译失败，因为存在编译错误。可能原因是工程文件夹及其路径包含非 ASCII 字符 | 将工程文件夹及其所在路径重命名为纯英文后重新上传 |
| [An abnormal situation has occured:the PlayerLoop internal function has been called recursively.](https://docs.vrcd.org.cn/books/unity-unity/page/an-abnormal-situation-has-occured) | PlayerLoop 内部函数被递归调用。可能原因是工程文件夹及其路径包含非 ASCII 字符 | 将工程文件夹及其所在路径重命名为纯英文后重新上传 |
| This avatar uses Visemes but the Face Mesh is not specified. | Avatar 使用了 Visemes 但是没有指定面部网格 | 正确配置 LipSync 的 Face Mesh |
| The VRCSDK build was aborted because the VRCSDKPreprocessAvatarCallback '{name}' reported a failure. | VRCSDK 构建终止，因为 VRCSDK 预处理回调 '{name}' 报告了不可恢复错误 | 咨询你身边的 Unity 编程高手。认真的。 |
| **原文** | **含义** | **解决方法** |
| VRCExpressionParameters has too many parameters defined. | 网络同步的 VRC Expression 参数超过 256 bits | 尝试删除一些需要同步参数的功能或预制件 |
| VRCExpressionsMenu uses a parameter that is not defined | VRC Expression Menu 引用了未在 VRC Expression Parameter 中注册的参数 | 菜单使用的参数应该被添加到参数列表中 |
| Images used for Actions & Moods are too large. | VRC Expression Menu 使用了尺寸大于 256×256 的图片 | 菜单图片尺寸应当小于等于 256×256 |
| Phys Bone Components: {n} - Avatar exceeds the maximum limit (256) of this component type. | 使用了 '{n}' 个 VRC PhysBone 组件，最多 256 个 | 尝试减少 VRC PhysBone 组件的使用 |
| Contact Component Count: {n} - Avatar exceeds the maximum limit (256) of this component type. | 使用了 '{n}' 个 VRC Contact 组件，最多 256 个 | 尝试减少 VRC Contact 组件的使用 |
| This avatar has mipmapped textures without 'Streaming Mip Maps' enabled. | Avatar 使用了开启 Mipmap 但未开启 Streaming Mip Maps 的纹理 | 在 SDK 面板对应的警告上使用 Auto Fix 或手动开启纹理的 Streaming Mip Maps |
| **原文** | **含义** | **解决方法** |
| [Failed to upload file.](https://docs.vrcd.org.cn/books/unity-unity/page/failed-to-upload-file) | 上传文件失败 | 网络问题 |
| [Could not fetch fresh config file. Using cached if available.](https://docs.vrcd.org.cn/books/unity-unity/page/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](https://docs.vrcd.org.cn/books/unity-unity/page/unauthorized-try-logging-out-and-in-again) | 未授权，请重新登录并重新尝试 | 网络问题，每次 IP 变动后需要重启 Unity 或 Reload SDK 后重新登陆 |
| **原文** | **含义** | **解决方法** |
| [Attempted to load the data for an avatar we do not own, clearing blueprint lD](https://docs.vrcd.org.cn/books/unity-unity/page/attempted-to-load-the-data-for-an-avatar-we-do-not-own-clearing-blueprint-ld) | 无法加载不属于你的虚拟形象数据，正在清除蓝图 lD | 只要初次上传失败就会出现该日志，没有实际意义 |
| **症状描述** | **解决办法** |
| 材质是紫色的 | 没有导入对应着色器包，请阅读安装手册并正确导入。一般是 lilToon；或材质与模型是分开的包，请先导入材质再导入模型 |
| 无法打开 VRCSDK 面板，控制台提示“Could not fetch fresh config file. Using cached if available” | SDK 无法获得最新的在线配置更新，可能是网络问题 |
| lilToon 材质检查器上的文本都消失了 | 使用 ALCOM 重装 lilToon |
| 出现编译错误，控制台提示“The Type or namespace name 'lilToonInspector' could not be found” | 更新使用了 lilToon 代码的插件或手动创建程序集定义引用 lilToon 程序集，因为 lilToon 2.0 关闭了程序集自动导出。 |
| Viseme 不工作 | LipSync 混合形状没有全部指定，或任意 Playable Layer 控制器中任意动画录制了 lipsync 混合形状 (即使该动画没有播放) |
| VRCSDK 卡在 Building 状态没有任何响应 | 你是否双击了 prefab 并尝试上传？请创建场景将 prefab 拖进场景中再尝试上传 |
| 录制动画时 Avatar 变成骑自行车姿势，但取消动画录制后变不回去了，我该怎么办？ | 这是 Unity 的 Bug。请不要将 Avatar 完全解压缩到场景中，请使用 prefab 和 prefab variant 以避免不可恢复的破坏修改 |