使用Riot API时英雄联盟召唤师PUUID为何会发生变更？

一、PUUID变更的核心原因 #

你之前的认知没错，PUUID默认是单服务器内的唯一标识，但出现以下情况时会发生变更：

• 账号完成跨服务器转移：哪怕是转出后再转回原服务器，PUUID都会重新生成；
• 极端账号体系异常：Riot账号系统更新时的罕见bug，不过官方一般会同步修复关联数据；
• 账号注销重建：但LEC职业选手的官方账号基本不会出现这种情况，可忽略。

二、稳定获取LEC选手数据的解决方案 #

针对职业选手这类身份明确的群体，推荐这几个靠谱方案：

1. 依托Riot全局账号ID（游戏名+标签）
   LEC选手的Riot账号标签（Tag Line）一般是战队固定缩写，不会随意更改。用Riot开发者API的account/v1/accounts/by-riot-id接口，传入选手的「游戏名+标签」就能稳定获取对应的PUUID和账号信息，这比单独用召唤师名或PUUID靠谱得多。
2. 本地维护选手映射表+定期校验
   • 先批量收集所有LEC选手的召唤师名、PUUID、Riot ID信息，存到本地数据库做映射；
   • 每天定时用summoner/v4/summoners/by-name接口查选手当前PUUID：
     • 和本地一致就直接拉数据；
     • 不一致的话，用新PUUID查Riot ID，确认是同一选手后更新映射表；
3. 调用官方赛事API
   Riot的赛事API（比如lol/esports/v1/tournaments）会返回官方认证的参赛选手数据，里面带固定的选手赛事ID，直接关联对应的召唤师账号信息，完全避开召唤师名或PUUID变更的问题。

三、避坑提示 #

• 调用API时严格遵守Riot的速率限制，别触发封禁；
• 职业选手的账号信息优先取官方赛事或LEC官网公布的，别依赖第三方来源；
• 若遇到PUUID变更，第一时间用Riot ID验证账号归属，避免错绑数据。

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