Telegram Login Widget 如何验证用户数据
原文中文，约3000字，阅读约需8分钟。
📝
内容提要
使用Telegram进行OAuth验证的步骤：按字母顺序排序字段，计算HMAC_SHA256，比对结果与提供的hash是否相等。注意排除空字段和hash字段。提供了Go和Python示例代码。
🔎
延伸解读
验证流程中的两个关键细节
文章指出，在组装待验证字符串时，必须排除 hash 字段本身，否则无法计算出正确结果。此外，对于 username、photo_url 等非必填字段，如果值为空，也不应参与计算。这两个细节在官方文档和示例代码中均未明确提及，是实际开发中容易忽略的坑。
官方文档的不足与开发者应对
作者提到，无论是 Telegram 官方文档还是其提供的 PHP 示例代码，都没有说明空字段不参与计算的问题。这意味着开发者如果直接照搬官方示例，可能会遇到验证失败的情况。因此，在实现验证逻辑时，需要自行处理空字段的排除，而不能完全依赖官方资料。
示例代码的参考价值
文章提供了 Go 和 Python 的验证示例代码，展示了如何正确实现字段排序、空字段排除、HMAC-SHA256 计算等步骤。这些代码可以作为开发者实现 Telegram 登录验证的参考，帮助避免上述两个坑，提高验证的成功率。
❓
Q&A
如何使用Telegram进行OAuth验证？
使用Telegram进行OAuth验证需要按字母顺序排序字段，组装字符串，计算HMAC_SHA256，并比对结果与提供的hash是否相等。
在验证过程中需要排除哪些字段？
在验证过程中需要排除hash字段和空值字段，如username和photo_url。
为什么官方文档没有提到空字段不参与计算？
官方文档和示例代码未提及空字段不参与计算的问题，可能导致用户误解。
提供的示例代码有哪些编程语言？
提供的示例代码包括Go和Python两种编程语言。
如何计算HMAC_SHA256？
计算HMAC_SHA256需要使用组装好的字符串和bot token的SHA256作为密码进行计算。
验证用户数据的主要目的是为了什么？
验证用户数据的主要目的是确保数据来自Telegram而非伪造。
🏷️
