Zotify项目歌词获取问题的分析与解决方案

问题背景

在音乐下载工具Zotify的使用过程中，用户报告了一个普遍存在的问题：系统无法获取任何歌曲的歌词，即使是那些在Spotify平台上确实存在歌词的歌曲。当尝试获取歌词时，程序会输出"Spotify API Error (unknown): received an empty response"的错误信息，并跳过该歌曲的歌词下载。

问题分析

经过技术分析，这个问题源于Spotify API对请求头的验证机制发生了变化。Spotify服务器现在会检查请求中的User-Agent头信息，如果缺失或不符合要求，就会返回空响应。这是Spotify加强API安全性和防止滥用的一种常见做法。

解决方案

针对这个问题，社区开发者FlyingButteryTuna提出了一个简单有效的修复方案：在zotify.py文件中修改get_auth_header方法，添加合适的User-Agent头信息。

具体修改如下：

1. 定位到zotify.py文件中的get_auth_header类方法
2. 在返回的headers字典中添加'User-Agent'字段
3. 使用常见的浏览器User-Agent字符串，如Chrome浏览器的标识

修改后的代码示例如下：

@classmethod
def get_auth_header(cls):
    return {
        'Authorization': f'Bearer {cls.__get_auth_token()}',
        'Accept-Language': f'{cls.CONFIG.get_language()}',
        'Accept': 'application/json',
        'app-platform': 'WebPlayer',
        'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36',
    }

实施步骤

对于不同安装方式的用户，修改文件的路径可能有所不同：

1. pipx安装用户：文件通常位于~/.local/share/pipx/venvs/zotify/lib/python3.x/site-packages/zotify目录下
2. pip安装用户：文件可能在Python的site-packages目录中
3. 源码安装用户：直接修改项目目录中的相应文件

修改完成后，无需重新安装，直接运行程序即可生效。

技术原理

这个解决方案之所以有效，是因为：

1. Spotify API现在要求请求包含有效的User-Agent头
2. 使用常见浏览器的User-Agent可以模拟正常用户请求
3. 完整的请求头信息让API服务器认为请求来自合法的客户端
4. 这种修改不会影响其他功能的正常使用

验证与反馈

多位用户已经验证了这个解决方案的有效性，包括问题报告者iop0p和其他社区成员。修改后，Zotify能够正常获取所有有歌词的歌曲的歌词信息，不再出现空响应错误。

总结

这个案例展示了API服务提供方如何通过请求头验证来增强服务安全性，以及开发者如何通过简单的修改来适应这些变化。对于使用Zotify遇到歌词获取问题的用户，按照上述方案修改代码即可解决问题。这也提醒我们，在开发依赖第三方API的应用时，需要关注API提供方的更新和变化，及时调整自己的实现方式。