HMCL外置登录账号刷新问题分析与解决方案

问题背景

在使用基于Next.js实现的Yggdrasil外置登录服务时，用户发现HMCL启动器无法正确刷新账号信息，而其他启动器如PCL2则能正常工作。该问题表现为HMCL在尝试获取Yggdrasil服务器元数据时出现JSON解析错误。

技术分析

问题现象

当HMCL尝试从Yggdrasil服务端点获取元数据时，服务端返回了重定向响应（从/api/yggdrasil/重定向到/api/yggdrasil），但HMCL未能正确处理这个重定向流程，而是直接将重定向后的URL路径"/api/yggdrasil"作为响应内容进行JSON解析，导致解析失败。

根本原因

1. URL规范差异：HMCL会自动为Yggdrasil服务端点URL添加尾部斜杠（/），而服务端实现则期望不带斜杠的路径。

2. 重定向处理不足：HMCL当前版本(3.5.7)在请求Yggdrasil元数据时，未能正确处理HTTP 3xx重定向响应，而是直接将重定向目标路径作为响应内容处理。

3. 服务端实现：服务端对带斜杠和不带斜杠的URL路径采取了不同的处理方式，这虽然符合HTTP规范，但不是所有客户端都能妥善处理。

解决方案

临时解决方案

1. 服务端调整：修改服务端实现，使/api/yggdrasil和/api/yggdrasil/都能返回相同的响应内容，避免重定向。

2. 客户端配置：在HMCL中配置Yggdrasil服务URL时，明确指定不带尾部斜杠的完整路径。

长期建议

1. HMCL改进方向：

   • 增强对HTTP重定向的处理能力
   • 改进URL规范化逻辑，避免强制添加尾部斜杠
   • 提供更友好的错误提示，帮助用户识别此类配置问题

2. 服务端实现建议：

   • 遵循Yggdrasil规范，确保API端点无论是否以斜杠结尾都能正常工作
   • 避免在关键API路径上使用重定向
   • 提供清晰的API文档说明URL格式要求

技术细节

Yggdrasil认证协议要求服务端提供标准的JSON格式元数据响应。当HMCL请求元数据时，完整的流程应该是：

1. HMCL向配置的Yggdrasil服务URL（如https://example.com/api/yggdrasil/）发送GET请求
2. 服务端应直接返回包含"meta"、"skinDomains"等字段的JSON响应
3. HMCL解析该响应并更新账号信息

当服务端实现不规范时（如依赖重定向），就会导致HMCL这类严格遵循规范的客户端出现问题。

总结

这个问题反映了客户端与服务端在API设计预期上的差异。作为Yggdrasil服务提供者，应当确保API端点的稳定性和兼容性；而作为客户端，HMCL也可以增强对非标准实现的容错能力。双方遵循同一套规范是确保兼容性的最佳实践。