为何HttpClient.GetAsync请求特定Spotify URL返回500错误？

首先看这个Spotify oEmbed接口URL：

https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES

用C#的HttpClient.GetAsync请求时会返回500内部服务器错误，最小复现代码如下：

var client = new HttpClient();
var res = await client.GetAsync(
    "https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES");

Console.WriteLine(res.StatusCode); // 输出 InternalServerError

但以下几种请求方式都能正常获取结果：

• 直接在浏览器地址栏访问该URL，可正常返回oEmbed数据；
• 使用curl命令请求：

curl "https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES"

• 使用JavaScript的fetch API请求：

fetch("https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES")
    .then(res => {
        console.log(res)
    })

• 使用PowerShell的Invoke-WebRequest请求：

Invoke-WebRequest "https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES"

核心差异：请求头中的User-Agent字段 #

C#的HttpClient默认使用的User-Agent格式是HttpClient/.NET（具体值取决于.NET版本），而浏览器、curl、fetch等工具会发送更符合标准的浏览器或客户端标识。Spotify的oEmbed服务器可能对这种极简的User-Agent做了限制，导致返回500错误。

解决方法：手动设置User-Agent #

修改代码，给HttpClient添加符合常见格式的User-Agent请求头即可：

var client = new HttpClient();
client.DefaultRequestHeaders.UserAgent.ParseAdd("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36");

var res = await client.GetAsync(
    "https://open.spotify.com/oembed?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZF1DWTggY0yqBxES");

Console.WriteLine(res.StatusCode); // 输出 OK

你也可以使用curl的User-Agent标识，比如curl/7.88.1，同样能解决问题。

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