UE5 + EOSPlus调用ReadFriendsList接口报错：EOS_Connect_QueryExternalAccountMappings返回EOS_InvalidParameters

你已经完成了登录功能验证和账号关联，却卡在好友列表查询这一步，结合错误日志里的EOS_Connect_QueryExternalAccountMappings()参数错误，给你几个针对性的排查方向：

• 核对ReadFriendsList的核心调用参数
  EOS的ReadFriendsList内部会触发外部账号映射查询，你需要确认调用EOS_Connect_ReadFriendsList时的EOS_Connect_ReadFriendsListOptions配置是否准确：

  • 确保ExternalAccountType明确设置为EOS_EAT_Steam，指定查询Steam平台好友；
  • 检查LocalUserId是否是当前已登录的有效EOS用户ID，别误传成Steam用户ID或者空值；
  • 如果是用EOS Plus封装的接口调用，也要确认封装层有没有正确传递这些关键参数，比如有没有遗漏平台类型的指定。

• 检查Epic开发者后台的Steam平台配置
  登录功能正常不代表好友查询的权限配置没问题：

  • 登录Epic开发者后台，进入你的应用EOS Connect配置页，确认Steam平台已添加，且Steam App ID、Steam Web API密钥填写完全正确；
  • 检查Steam平台的权限设置，是否开启了「读取好友列表」相关的权限（部分平台需要单独配置这类细分权限）。

• 验证账号关联的实际有效性
  账号关联可能存在后台同步延迟：

  • 尝试完全注销当前Steam和EOS登录会话，退出游戏后重新登录，再次确认Epic与Steam账号的关联状态；
  • 可以通过EOS Connect管理控制台，查看测试用户的关联账号列表，确认Steam账号确实显示为已关联状态。

• 确认接口调用时机的合理性
  必须确保ReadFriendsList在登录流程完全完成后调用：

  • 要等EOS_Login的回调返回成功（包括Steam登录回调和EOS Connect登录回调都完成），再触发好友列表查询；
  • 避免在初始化阶段或者登录过程中提前调用，此时用户会话可能还未完全建立，会导致参数无效。

• 单独测试QueryExternalAccountMappings接口
  既然错误直接指向这个接口，可以单独写一段测试代码调用EOS_Connect_QueryExternalAccountMappings：

  • 手动传递正确的LocalUserId、ExternalAccountType（Steam）以及当前用户的Steam账号ID；
  • 如果单独调用也报错，就能精准定位是哪个参数出了问题，比如Steam账号ID格式是否符合EOS要求，或者参数是否为空。

内容的提问来源于stack exchange，提问作者Saragan