C#客户端Post文件至服务器失败，Postman可正常运行

核心排查方向：Antiforgery Token的正确配对 #

服务器启用了Antiforgery验证，必须确保请求同时携带Cookie中的令牌和请求头/表单中的令牌，两者缺一不可且必须匹配，这是Postman能成功但客户端失败的核心原因。

1. 先确认/GetToken接口的返回逻辑 #

服务器的/GetToken接口需要返回两个关键内容：

• 响应头中的Set-Cookie，包含__RequestVerificationToken的Cookie值
• 响应体中的明文令牌字符串

客户端必须同时保留这两个值，不能只取响应体的令牌。

2. 客户端请求的正确构造代码 #

using (var client = new HttpClient(new HttpClientHandler { UseCookies = true }))
{
    // 获取令牌：HttpClient会自动保存Set-Cookie中的Cookie
    var tokenResponse = await client.GetAsync("https://your-server-url/GetToken");
    tokenResponse.EnsureSuccessStatusCode();
    var requestToken = await tokenResponse.Content.ReadAsStringAsync();

    // 构造上传请求
    using (var content = new MultipartFormDataContent())
    {
        // 添加文件内容，注意字段名要和服务器接口参数名一致（比如服务器用IFormFile file，这里就传"file"）
        var fileBytes = File.ReadAllBytes(@"C:\test.xlsx");
        var fileContent = new ByteArrayContent(fileBytes);
        fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        content.Add(fileContent, "file", "test.xlsx");

        // 关键：将令牌添加到表单（和服务器默认校验逻辑匹配）
        content.Add(new StringContent(requestToken), "__RequestVerificationToken");

        // 发送请求：HttpClient会自动携带之前保存的Cookie
        var uploadResponse = await client.PostAsync("https://your-server-url/upload2", content);
        var responseMsg = await uploadResponse.Content.ReadAsStringAsync();
        Console.WriteLine($"状态码：{(int)uploadResponse.StatusCode}，响应：{responseMsg}");
    }
}

3. 常见错误点排查 #

• 只传表单令牌没带Cookie：Antiforgery验证要求Cookie和请求中的令牌配对，缺任意一个都会返回400
• 令牌字段名不匹配：服务器默认的表单字段名是__RequestVerificationToken，如果客户端写成RequestVerificationToken会直接验证失败
• 跨域场景的Cookie配置：如果客户端和服务器跨域，需要在服务器端将Antiforgery Cookie的SameSite设为SameSiteMode.None，同时启用HTTPS
• 文件字段名不匹配：服务器接口的IFormFile参数名如果是excelFile，客户端添加文件时的字段名必须对应，否则服务器接收不到文件也可能返回400

4. 调试技巧 #

• 用Fiddler抓包对比Postman和客户端的请求，重点检查：
  • 请求头的Cookie中是否包含__RequestVerificationToken
  • 表单或请求头中的令牌值是否和Cookie中的一致
• 在服务器端添加验证失败日志，定位具体原因：

try
{
    // 接口原有逻辑
}
catch (AntiforgeryValidationException ex)
{
    _logger.LogError(ex, "Antiforgery验证失败：{Detail}", ex.Message);
    return BadRequest("令牌验证失败");
}

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