EOS SDK Error Codes

阅览表格确定SDK错误代码及响应的含义。

错误处理

当你使用EOS开发产品时,你可能会看到不同接口报告的错误。下表列出了一些常见的错误代码、原因及解决方案:-

数字错误代码错误代码/字符串代码错误信息文档原因解决方案
300errors.com.epicgames.common.policy_missing_action无法解锁成就客户端凭证客户端政策没有权限在开发者门户的产品设置
-> 客户端选项卡中添加缺失的政策。
401errors.com.epicgames.eos.auth.client_not_found未找到客户端:[id]没有配置客户端在开发者门户客户端中配置客户端。
1003errors.com.epicgames.forbidden(ECOM场景) 不允许访问属于xxxxxxxxxx账户的资源授权用户与检索的用户id不匹配
1011errors.com.epicgames.common.oauth.invalid_client无效客户端:'XXXXXXXXXXXXXX'协议不接受的协议/错误的客户端ID该错误会在新的协议还未被接受的时候出现 - 组织的所有者需要在开发者门户中进行接受。如果已经接受 - 检查是否使用了正确的客户端ID/Secret并且确保它们是EOS SDK凭证。
1012errors.com.epicgames.bad_request客户端没有正确配置。请确保已经与应用关联。检查EAS设置是否完成客户端没有与应用配置。可能是因为组织所有者没有接受EAS协议并且完成这一步,或者将客户端链接到了EAS配置。
1012errors.com.epicgames.common.oauth.invalid_grantinvalid_grant授权界面错误的授权种类 (电子邮箱/密码)
1012errors.com.epicgames.oauth.account_forbidden账户无法访问部署 'XXXXXXXXXX'产品管理私人沙盒
沙盒应该设为对EGS合作伙伴公开。
1012errors.com.epicgames.server_error罗列oauth scopes发生错误内部Epic错误
1023errors.com.epicgames.common.missing_permission抱歉,你的登录不含有需要的 'egp:account:token:otherSessionsForAccountClientService DELETE' 来进行所请求的操作版本更新1.5 SDK之后创建的新客户端不再默认包含该权限。这会在旧版本SDK (1.4以及更早) 使用1.5客户端的时候出现。对于1.4或者更早版本,添加权限。对于1.5以后的版本,Epic正在进行修复。
1023errors.com.epicgames.common.missing_permission抱歉,你的登录不含有需要的 'egp:account:public:account READ' 来进行所请求的操作版本更新1.5
SDK之后创建的新客户端不再默认包含该权限。这会在旧版本SDK (1.4以及更早) 使用1.5客户端的时候出现。对于1.4或者更早版本,添加权限。对于1.5以后的版本,Epic正在进行修复。
1040errors.com.epicgames.validation.validation_failed验证失败。无效字段为[LineOffers]商品 (DLC/附加内容) 未找到或无效商品的枚举和验证设置没有设为可发现,或者在当前产品下不存在。联系你的服务配送管理员来确认商品是否在正确的产品下并且正确配置。
18603errors.com.epicgames.account.external_auth_validate_failed无法验证令牌,authType: steam_encrypted_appticket sandboxId: XXX, 错误:无法找到sandboxId: xxxxxxxxxxx的沙盒凭证 identityProvider: steam身份提供管理Steam没有配置为身份提供者并添加到沙盒确保身份提供者用有效的加密密钥为产品配置,并且添加到开发者门户的沙盒。环境 -> 沙盒 -> 身份提供者 -> Steam。
18603errors.com.epicgames.account.external_auth_validate_failed开发者门户中输入的加密密钥与Steamworks不匹配确保Steamwoks控制面板中的Steam加密密钥与EOS开发者门户中的一致。检查在Steamwoeks中将变动进行了发布,因为有可能输入/生成了一个新的密钥而没有将其发布,也就意味着密钥没有对齐。
46022errors.com.epicgames.ecommerce.integration.client_restricted你没有权限访问该资源,请联系身份支持团队。Epic账户服务从令牌请求去除了部署ID确保POST https://api.epicgames.dev/epic/oauth/v1/token请求中包含deployment_id=foo。
58005errors.com.epicgames.oauth.scope_consent_required用户没有连接到需要的scopes。开发者门户SDK请求和客户端功能不匹配
SDK需要在开发者门户中用与EOS客户端一样的scope进行初始化。将客户端代码和/或开发者门户匹配。
110016errors.com.epicgames.eos.auth.user_not_found未找到EOS用户身份连接界面用户账号没有在EOS注册在EOS中注册。

错误结果

来自EOS SDK函数的错误代码使用类型 EOS_EResult。此类型包括常见错误值和特定于单个接口的错误。常见错误采用 EOS\_<ErrorCode> 形式,而接口特定错误代码显示为 EOS\_<Interface>\_<ErrorCode>。 例如:EOS_Initialize 返回EOS_EResult来指示成功或失败。如果SDK初始化成功,则值为 EOS_Success,否则,该值将指示错误,例如 EOS_AlreadyConfigured

数字代码返回代码原因
0EOS_Success/** 结果显示成功。无需进一步的错误处理 */
1EOS_NoConnection/** 因没有连接而导致失败 */
2EOS_InvalidCredentials/** 因凭证无效导致登录失败 */
3EOS_InvalidUser/** 因无效用户或缺少用户而导致失败 */
4EOS_InvalidAuth/** 因无效或缺失用户身份验证令牌而导致失败,例如未登录 */
5EOS_AccessDenied/** 因无效访问而导致失败 */
6EOS_MissingPermissions/** 客户端不具备所需权限 */
7EOS_Token_Not_Account/** 提供的令牌无对应账号 */
8EOS_TooManyRequests/** 请求过多导致限制 */
9EOS_AlreadyPending/** 异步请求已处于挂起状态 */
10EOS_InvalidParameters/** 请求指定参数无效 */
11EOS_InvalidRequest/** 请求无效 */
12EOS_UnrecognizedResponse/** 因无法解析或识别后端响应而导致失败 */
13EOS_IncompatibleVersion/** 后端版本的客户端不兼容 */
14EOS_NotConfigured/** 未正确配置以供使用 */
15EOS_AlreadyConfigured/** 已配置供使用。*/
16EOS_NotImplemented/** 功能在此实现中不可用 */
17EOS_Canceled/** 操作可能已被用户取消 */
18EOS_NotFound/** 未找到请求的信息 */
19EOS_OperationWillRetry/** 异步操作期间发生错误,将重试。收到此结果的回调将来会再次调用。*/
20EOS_NoChange/** 请求无效 */
21EOS_VersionMismatch/** 请求尝试使用多个或不一致的API版本 */
22EOS_LimitExceeded/** 客户端超出最大限制,与`EOS_TooManyRequests不同 */
23EOS_Disabled/** 执行该操作的功能或客户端ID已禁用。*/
24EOS_DuplicateNotAllowed/** 不允许重复输入 */
25EOS_MissingParameters_DEPRECATED/** 缺少必要参数。已弃用:不再报此错误。*/
26EOS_InvalidSandboxId/** 沙盒ID无效 */
27EOS_TimedOut/** 请求超时 */
28EOS_PartialResult/** 查询返回了部分(非全部)请求结果。*/
29EOS_Missing_Role/** 客户端缺少列入白名单的角色 */
30EOS_Missing_Feature/** 客户端缺少列入白名单的功能 */
31EOS_Invalid_Sandbox/** 后端给定沙盒无效 */
32EOS_Invalid_Deployment/** 后端给定部署无效 */
33EOS_Invalid_Product/** 后端指定产品ID无效 */
34EOS_Invalid_ProductUserID/** 后端指定产品用户ID无效 */
35EOS_ServiceFailure/** 后端服务出现故障 */
36EOS_CacheDirectoryMissing/** 平台选项中未设置缓存目录。*/
37EOS_CacheDirectoryInvalid/** 缓存目录不可访问。*/
38EOS_InvalidState/** 资源处于无效状态,请求失败 */
39EOS_RequestInProgress/** 请求正在进行中 */
1001EOS_Auth_AccountLocked/** 登录失败导致账号锁定 */
1002EOS_Auth_AccountLockedForUpdate/** 账号因更新操作锁定。*/
1003EOS_Auth_InvalidRefreshToken/** 使用的刷新令牌无效 */
1004EOS_Auth_InvalidToken/** 访问令牌无效,通常出现在切换后端环境时 */
1005EOS_Auth_AuthenticationFailure/** Bearer令牌无效 */
1006EOS_Auth_InvalidPlatformToken/** 平台令牌无效 */
1007EOS_Auth_WrongAccount/** 身份验证参数未与此账号关联 */
1008EOS_Auth_WrongClient/** 身份验证参数未与此客户端关联 */
1009EOS_Auth_FullAccountRequired/** 需要完整账号 */
1010EOS_Auth_HeadlessAccountRequired/** 需要无头账号 */
1011EOS_Auth_PasswordResetRequired/** 需要重置密码 */
1012EOS_Auth_PasswordCannotBeReused/** 密码之前使用过,无法重复使用 */
1013EOS_Auth_Expired/** 授权码/兑换码已过期 */
1014EOS_Auth_ScopeConsentRequired/** 用户未同意 */
1015EOS_Auth_ApplicationNotFound/** 该应用程序在后端没有配置文件 */
1016EOS_Auth_ScopeNotFound/** 后端未找到请求同意 */
1017EOS_Auth_AccountFeatureRestricted/** 此账号已被拒绝登录 */
1020EOS_Auth_PinGrantCode/** 已启动PIN授权代码 */
1021EOS_Auth_PinGrantExpired/** PIN授权码尝试已过期 */
1022EOS_Auth_PinGrantPending/** PIN授权代码尝试挂起 */
1030EOS_Auth_ExternalAuthNotLinked/** 外部身份验证源无相关账号 */
1032EOS_Auth_ExternalAuthRevoked/** 外部授权访问已撤销 */
1033EOS_Auth_ExternalAuthInvalid/** 无法解译外部身份验证令牌 */
1034EOS_Auth_ExternalAuthRestricted/** 限制导致外部身份验证无法关联到此账号 */
1035EOS_Auth_ExternalAuthCannotLogin/** 外部身份验证无法用于登录 */
1036EOS_Auth_ExternalAuthExpired/** 外部身份验证已过期 */
1037EOS_Auth_ExternalAuthIsLastLoginType/** 无法删除外部身份验证,因为它是最终的备用登录方式 */
1040EOS_Auth_ExchangeCodeNotFound/** 未找到兑换码 */
1041EOS_Auth_OriginatingExchangeCodeSessionExpired/** 原始兑换码会话已过期 */
1050EOS_Auth_PersistentAuth_AccountNotActive/** 该账号已禁用,无法用于身份验证 */
1060EOS_Auth_MFARequired/** 需要接受MFA质询 */
1070EOS_Auth_ParentalControls/** 家长控制已到位 */
1080EOS_Auth_NoRealId/** 缺少必要的韩国真实ID关联 */
2000EOS_Friends_InviteAwaitingAcceptance/** 发出的好友邀请正在等待接受;向同一用户再次发送邀请会报错 */
2001EOS_Friends_NoInvitation/** 没有要接受/拒绝的好友邀请 */
2003EOS_Friends_AlreadyFriends/** 用户已经是好友,所以再次发送邀请会报错 */
2004EOS_Friends_NotFriends/** 用户不是好友,删除好友会报错 */
2005EOS_Friends_TargetUserTooManyInvites/** 远程用户的邀请过多,无法接收新邀请 */
2006EOS_Friends_LocalUserTooManyInvites/** 本地用户的邀请过多,无法发送新邀请 */
2007EOS_Friends_TargetUserFriendLimitExceeded/** 远程用户的好友太多,无法添加新好友 */
2008EOS_Friends_LocalUserFriendLimitExceeded/** 本地用户的好友太多,无法添加新好友 */
3000EOS_Presence_DataInvalid/** 请求数据为空或无效 */
3001EOS_Presence_DataLengthInvalid/** 请求中包含太多或太少的唯一数据项,或者请求将超出允许的最大数据量 */
3002EOS_Presence_DataKeyInvalid/** 请求中包含具有无效密钥的数据 */
3003EOS_Presence_DataKeyLengthInvalid/** 请求中包含密钥过长或过短的数据 */
3004EOS_Presence_DataValueInvalid/** 请求中包含具有无效值的数据 */
3005EOS_Presence_DataValueLengthInvalid/** 请求中含有值太长的数据 */
3006EOS_Presence_RichTextInvalid/** 请求中包含无效的富文本字符串 */
3007EOS_Presence_RichTextLengthInvalid/** 请求中包含过长的富文本字符串 */
3008EOS_Presence_StatusInvalid/** 请求中包含无效状态 */
4000EOS_Ecom_EntitlementStale/** 检索到的权利已过时,请重新查询更新信息 */
4001EOS_Ecom_CatalogOfferStale/** 检索到的商品已过时,请重新查询更新信息 */
4002EOS_Ecom_CatalogItemStale/** 检索到的项目或关联结构已过时
4003EOS_Ecom_CatalogOfferPriceInvalid/** 一个或多个商品的价格无效。这可能由价格设置导致。*/
4004EOS_Ecom_CheckoutLoadError/** 检出页面未能加载 */
5000EOS_Sessions_SessionInProgress/** 会话已在进行中 */
5001EOS_Sessions_TooManyPlayers/** 太多玩家无法注册此会话 */
5002EOS_Sessions_NoPermission/** 客户端无权访问此会话 */
5003EOS_Sessions_SessionAlreadyExists/** 会话已存在于系统中 */
5004EOS_Sessions_InvalidLock/** 操作需要的会话锁 */
5005EOS_Sessions_InvalidSession/** 会话参考无效 */
5006EOS_Sessions_SandboxNotAllowed/** 与身份验证关联的沙盒ID不匹配 */
5007EOS_Sessions_InviteFailed/** 邀请发送失败 */
5008EOS_Sessions_InviteNotFound/** 未找到服务邀请 */
5009EOS_Sessions_UpsertNotAllowed/** 此客户端不可修改会话 */
5010EOS_Sessions_AggregationFailed/** 后端节点无法处理请求 */
5011EOS_Sessions_HostAtCapacity/** 单个后端节点已满负荷*/
5012EOS_Sessions_SandboxAtCapacity/** 节点上的沙盒已满负荷 */
5013EOS_Sessions_SessionNotAnonymous/** 在非匿名会话上尝试匿名操作 */
5014EOS_Sessions_OutOfSync/** 会话当前与后端不同步,数据保存在本地但需要与后端同步 */
5015EOS_Sessions_TooManyInvites/** 用户收到太多邀请 */
5016EOS_Sessions_PresenceSessionExists/** 客户端的在线状态会话已存在 */
5017EOS_Sessions_DeploymentAtCapacity/** 节点上的部署已满负荷 */
5018EOS_Sessions_NotAllowed/** 不允许会话操作 */
6000EOS_PlayerDataStorage_FilenameInvalid/** 请求文件名无效 */
6001EOS_PlayerDataStorage_FilenameLengthInvalid/** 请求文件名太长 */
6002EOS_PlayerDataStorage_FilenameInvalidChars/** 请求文件名包含无效字符 */
6003EOS_PlayerDataStorage_FileSizeTooLarge/** 请求操作会使文件变得太大 */
6004EOS_PlayerDataStorage_FileSizeInvalid/** 请求文件长度无效 */
6005EOS_PlayerDataStorage_FileHandleInvalid/** 请求文件句柄无效 */
6006EOS_PlayerDataStorage_DataInvalid/** 请求数据无效 */
6007EOS_PlayerDataStorage_DataLengthInvalid/** 请求数据长度无效 */
6008EOS_PlayerDataStorage_StartIndexInvalid/** 请求开始索引无效 */
6009EOS_PlayerDataStorage_RequestInProgress/** 请求正在进行中 */
6010EOS_PlayerDataStorage_UserThrottled/** 用户被标记为受限制,这意味着他无法执行某些操作,因为超出限制。*/
6011EOS_PlayerDataStorage_EncryptionKeyNotSet/** SDK初始化期间未设置加密密钥。*/
6012EOS_PlayerDataStorage_UserErrorFromDataCallback/** 用户数据回调返回错误EOS_PlayerDataStorage_EWriteResult::EOS_WR_FailRequest或EOS_PlayerDataStorage_EReadResult::EOS_RR_FailRequest */
6013EOS_PlayerDataStorage_FileHeaderHasNewerVersion/** 用户正在尝试从较新版本的SDK读取具有标头的文件。需要更新游戏/SDK。*/
6014EOS_PlayerDataStorage_FileCorrupted/** 文件已损坏。在某些情况下,重试可以解决问题。*/
7000EOS_Connect_ExternalTokenValidationFailed/** `EOS身份验证服务认为外部令牌无效 */
7001EOS_Connect_UserAlreadyExists/** `EOS身份验证用户已存在 */
7002EOS_Connect_AuthExpired/** `EOS身份验证已过期 */
7003EOS_Connect_InvalidToken/** `EOS身份验证无效令牌*/
7004EOS_Connect_UnsupportedTokenType/** `EOS身份验证不支持此令牌类型 */
7005EOS_Connect_LinkAccountFailed/** `EOS身份验证账号关联失败 */
7006EOS_Connect_ExternalServiceUnavailable/** `用于验证的EOS身份验证外部服务不可用 */
7007EOS_Connect_ExternalServiceConfigurationFailure/** `使用开发人员门户的EOS身份验证外部服务配置失败 */
7008EOS_Connect_LinkAccountFailedMissingNintendoIdAccount_DEPRECATED/** `EOS身份验证账号关联失败。尝试在未先关联任天堂账号的情况下关联任天堂网络服务账号。已弃用:该要求已删除,并且不再报此错误。*/
8000EOS_UI_SocialOverlayLoadError/** 社交覆层页面加载失败 */
9000EOS_Lobby_NotOwner/** 客户端没有修改此大厅的权限 */
9001EOS_Lobby_InvalidLock/** 操作需要大厅锁 */
9002EOS_Lobby_LobbyAlreadyExists/** 大厅已存在于系统中 */
9003EOS_Lobby_SessionInProgress/** 大厅会话已在进行中 */
9004EOS_Lobby_TooManyPlayers/** 此大厅玩家太多,无法注册 */
9005EOS_Lobby_NoPermission/** 客户端没有访问此大厅的权限 */
9006EOS_Lobby_InvalidSession/** 大厅会话参考无效 */
9007EOS_Lobby_SandboxNotAllowed/** 与身份验证关联的沙盒ID不匹配 */
9008EOS_Lobby_InviteFailed/** 邀请发送失败 */
9009EOS_Lobby_InviteNotFound/** 未找到该服务的邀请 */
9010EOS_Lobby_UpsertNotAllowed/** 此客户端不可修改该大厅 */
9011EOS_Lobby_AggregationFailed/** 后端节点无法处理请求 */
9012EOS_Lobby_HostAtCapacity/** 单个后端节点已满负荷 */
9013EOS_Lobby_SandboxAtCapacity/** 节点上的沙盒已满负荷 */
9014EOS_Lobby_TooManyInvites/** 用户收到的邀请太多 */
9015EOS_Lobby_DeploymentAtCapacity/** 节点上的部署已满负荷 */
9016EOS_Lobby_NotAllowed/** 不允许大厅操作 */
9017EOS_Lobby_MemberUpdateOnly/** 在恢复丢失连接时,大厅所有权发生变更,并且仅更新本地成员数据 */
9018EOS_Lobby_PresenceLobbyExists/** 客户端已存在在线状态大厅 */
10000EOS_TitleStorage_UserErrorFromDataCallback/** 从存储接收数据的用户回调返回了错误。*/
10001EOS_TitleStorage_EncryptionKeyNotSet/** 用户忘记在平台初始化期间设置加密密钥。没有它,作品存储(Title Storage)无法运行。*/
10002EOS_TitleStorage_FileCorrupted/** 下载文件已损坏。*/
10003EOS_TitleStorage_FileHeaderHasNewerVersion/** 下载文件的格式比客户端SDK版本新。*/
11000EOS_Mods_ModSdkProcessIsAlreadyRunning/** ModSdk进程正在运行中。此错误来自 `EOSSDK。*/
11001EOS_Mods_ModSdkCommandIsEmpty/** ModSdk命令为空。ModSdk配置文件丢失或清单位置为空。*/
11002EOS_Mods_ModSdkProcessCreationFailed/** 创建ModSdk进程失败。此错误来自SDK。*/
11003EOS_Mods_CriticalError/** 外部ModSdk进程中发生了我们无法解决的严重错误。*/
11004EOS_Mods_ToolInternalError/** 外部ModSdk进程中发生了我们无法解决的内部错误。*/
11005EOS_Mods_IPCFailure/** 外部ModSdk进程发生IPC故障。*/
11006EOS_Mods_InvalidIPCResponse/** 外部ModSdk进程收到无效的IPC响应。*/
11007EOS_Mods_URILaunchFailure/** 外部ModSdk进程发生URI启动故障。*/
11008EOS_Mods_ModIsNotInstalled/** 尝试使用未安装的mod执行操作。此错误来自外部ModSdk进程。*/
11009EOS_Mods_UserDoesNotOwnTheGame/** 尝试对用户未拥有的游戏执行操作。此错误来自外部ModSdk进程。*/
11010EOS_Mods_OfferRequestByIdInvalidResult/** 获取mod商品的请求结果无效。此错误来自外部ModSdk进程。*/
11011EOS_Mods_CouldNotFindOffer/** 找不到该mod的商品。此错误来自外部ModSdk进程。*/
11012EOS_Mods_OfferRequestByIdFailure/** 获取该mod商品的请求失败。此错误来自外部ModSdk进程。*/
11013EOS_Mods_PurchaseFailure/** 购买该mod的请求失败。此错误来自外部ModSdk进程。*/
11014EOS_Mods_InvalidGameInstallInfo/** 尝试对未安装或部分安装的游戏执行操作。此错误来自外部ModSdk进程。*/
11015EOS_Mods_CannotGetManifestLocation/** 未能获取清单位置。ModSdk配置文件丢失或清单位置为空 */
11016EOS_Mods_UnsupportedOS/** 尝试使用不支持当前操作系统的mod执行操作。*/
12000EOS_AntiCheat_ClientProtectionNotAvailable/** 反作弊客户端保护不可用。查看游戏是否使用正确的启动器启动。*/
12001EOS_AntiCheat_InvalidMode/** 当前的反作弊模式不适合使用此API */
12002EOS_AntiCheat_ClientProductIdMismatch/** 提供给反作弊客户端辅助可执行文件的ProductId与用于初始化`EOS SDK的内容不匹配 */
12003EOS_AntiCheat_ClientSandboxIdMismatch/** 提供给反作弊客户端辅助可执行文件的SandboxId与用于初始化`EOS SDK的内容不匹配 */
12004EOS_AntiCheat_ProtectMessageSessionKeyRequired/** ProtectMessage/UnprotectMessage 没有可用的会话密钥,但需要完成此操作 */
12005EOS_AntiCheat_ProtectMessageValidationFailed/** ProtectMessage/UnprotectMessage 消息完整性无效 */
12006EOS_AntiCheat_ProtectMessageInitializationFailed/** ProtectMessage/UnprotectMessage 初始化失败 */
12007EOS_AntiCheat_PeerAlreadyRegistered/** RegisterPeer 对等端已注册 */
12008EOS_AntiCheat_PeerNotFound/** UnregisterPeer 对等端不存在 */
12009EOS_AntiCheat_PeerNotProtected/** ReceiveMessageFromPeer调用无效:对等端不受保护 */
13000EOS_RTC_TooManyParticipants/** `EOS RTC房间无法接受更多参与者 */
13001EOS_RTC_RoomAlreadyExists/** `EOS RTC房间已存在*/
13002EOS_RTC_UserKicked/** 用户被踢出房间 */
13003EOS_RTC_UserBanned/** 用户被封禁 */
13004EOS_RTC_RoomWasLeft/** 成功离开`EOS RTC房间 */
13005EOS_RTC_ReconnectionTimegateExpired/** 长时间超时导致断开连接 */
14000EOS_ProgressionSnapshot_SnapshotIdUnavailable/** 可用的Snapshot ID数已全部用完。*/
15000EOS_KWS_ParentEmailMissing/** KWS用户没有与该账号关联的家长电子邮箱。家长账号已取消关联或已删除 */
15001EOS_KWS_UserGraduated/** KWS用户不再是未成年人并尝试更新家长电子邮箱 */
17000EOS_Android_JavaVMNotStored/** `EOS Android VM未存储 */
0x7FFFFFFF_LASTEOS_UnexpectedError/** 发生了我们无法识别的意外错误。*/