解决your_spotify项目中的INVALID_CLIENT: Invalid redirect URI错误

在使用your_spotify项目时，许多用户在UNRAID环境下部署后遇到了"INVALID_CLIENT: Invalid redirect URI"的错误提示。这个问题通常出现在尝试通过Docker容器访问Spotify授权界面时。本文将详细分析问题原因并提供解决方案。

问题现象

用户在UNRAID系统中部署your_spotify容器后，点击登录链接时系统返回错误信息"INVALID_CLIENT: Invalid redirect URI"。从用户提供的截图可以看到，他们已正确设置了SPOTIFY_CLIENT_ID和SPOTIFY_CLIENT_SECRET等环境变量，但授权流程仍然失败。

根本原因

这个问题的核心在于Spotify OAuth授权流程中的重定向URI配置不匹配。Spotify的OAuth2.0授权机制要求客户端提供的重定向URI必须与在Spotify开发者门户中注册的URI完全一致，包括协议(http/https)、域名/IP和路径。

解决方案

经过技术分析，正确的重定向URI应该包含"/api"路径前缀。具体解决方案如下：

1. 在UNRAID的your_spotify容器配置中，确保重定向URI格式为： http://服务器IP:端口/api/oauth/spotify/callback

2. 同时，在Spotify开发者门户的应用设置中，必须添加完全相同的重定向URI。

配置建议

对于UNRAID用户，建议检查以下配置项：

1. 容器网络设置：确保端口映射正确，外部访问端口与内部服务端口一致
2. 环境变量：确认SPOTIFY_REDIRECT_URI变量设置为上述格式
3. 防火墙设置：确保UNRAID防火墙未阻止相关端口的访问

技术原理

Spotify的OAuth2.0授权流程对重定向URI有严格的安全验证机制。这个机制可以防止授权码被拦截和滥用。当客户端发起的授权请求中的重定向URI与注册URI不匹配时，Spotify服务器会拒绝该请求并返回INVALID_CLIENT错误。

通过添加"/api"路径前缀，我们确保了your_spotify后端服务能够正确处理OAuth回调，完成整个授权流程。这个路径是your_spotify项目API路由的标准前缀，用于区分前端路由和后端API端点。

总结

解决your_spotify项目中的重定向URI错误关键在于确保三处配置的一致性：Spotify开发者门户、容器环境变量和实际访问路径。通过遵循本文的建议配置，用户可以顺利完成Spotify授权流程，享受your_spotify提供的音乐统计服务。