---
title: 在 Zepeto Studio 上传 .zepetopackage 文件时出现 9999 错误。
slug: world-sdk-guide-ch/zepeto-studio-zepetopackage-9999
docTags: 
createdAt: 2025-01-20T06:20:46.591Z
---

在完成世界制作后，将 .zepetopackage 文件上传到 ZEPETO Studio 时如果出现 9999 错误，请尝试以下三种方法来解决。

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/DcUlkDIcohss3EeWDLNtY_china.png "错误屏幕示例")

## Case 1. 安装Unity时遗漏必需模块安装时

转到 **Unity Hub > Installs > 2022.3.34f1 > Add Modules** 并检查是否安装了所有必需的模块。

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/3eOCDYvRhZz_Yyz3Bn69n_image.png)

所需模块如下：

- Android Build Support
- iOS Build Support
- Mac Build Support (Mono) - 如果您的电脑运行的是 Windows，请安装。
- Windows Build Support (Mono) - 如果您的电脑运行的是 Mac，请安装。



**Mac**

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/mBI8Vz48s4OFOdhCqF5Cf_image.png)

**Windows**

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/q9dJzc1Q4ZwuxX8ubMJCn_image.png)

另外，单击 Publish 按钮旁边的登录菜单，并确保“Target Platforms”设置为“All”。

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/bR-5NddfXq8mWAqy-gxn7_image.png)

如果已安装所有必需的模块，请点击 Publish 按钮重新构建您的世界。

构建完成后，**打开项目文件夹 > Build > ZEPETO.Script** 文件夹，确认所有平台文件是否已生成。

所需的平台文件如下：

- android
- ios
- osx
- windows

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/xWzWMOa3H4-hMybsFyFgE_group-21.png)

将生成的 .zepetopackage 文件上传至 ZEPETO Studio。

有关更多详细信息，请参阅以下指南：

- [安装和设置](docId\:tP9UdUcHwsnU_92sPsVke) 
- [释放你的世界](docId:06Jp2RjOFTK9V0rdWm4HS) 



## Case 2. Windows 用户 - 文件或文件夹名称过长

在 Windows 环境中，路径名称的长度可能会影响包的构建。

如果 Assets 文件夹中包含名称过长的文件或文件夹，在上传至 Studio 时可能会出现 9999 错误。

请确保文件名中不包含空格或特殊字符。

将文件名更改为简洁的名称，例如 “abc.jpg”，然后重新构建项目。

即使是从 Unity Asset Store 自动生成的文件夹名称，也请将文件夹名称重命名为简洁的名称。



## Case 3. 安装必需模块后仍发生9999错误时

如果必需模块都安装好了还出现9999错误，请尝试以下方法。

::::WorkflowBlock
:::WorkflowBlockItem
删除项目文件夹中的 **Build** 文件夹 。

::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/-k2K6bZHY6SD_AbaN7jfo_group-18.png" size="52" width="1292" height="1656" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
更新 ZEPETO.World 软件包

(1) 在Unity中打开 **Window > Package Manager**， 在 **Packages** 中选择 **My Registries** 或 **In Project**。 

(2) 从包列表中选择**ZEPETO.World**，然后单击**Version History**标签。

(3) 更新到最新版本。

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/HH0HQUKu123a530rCkBcs_group-19-1.png)
:::

:::WorkflowBlockItem
按**Publish**按钮重新创建项目。
:::

:::WorkflowBlockItem
构建完成后，**打开项目文件夹 > Build > ZEPETO.Script **文件夹，确认各平台文件是否全部生成。 

需要的平台文件如下。

- android
- ios
- osx
- windows

::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/xWzWMOa3H4-hMybsFyFgE_group-21.png" size="70" width="1853" height="1003" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
将生成的.zepetopackage文件上传到盖比特工作室。
:::
::::