如何在Xunit集成测试中获取BadRequest响应的自定义错误详情并进行断言验证

嗨，我来帮你搞定这个断言！要验证接口返回的自定义错误信息，你需要先读取响应的JSON内容，然后反序列化提取detail字段。下面是具体的实现步骤：

步骤1：读取响应内容 #

首先，用ReadAsStringAsync()方法获取BadRequest响应的JSON字符串内容——因为接口的错误信息是嵌在响应体里的，不是HTTP状态码自带的描述。

步骤2：反序列化JSON内容 #

你可以选择两种方式解析JSON：定义实体类（类型安全，推荐），或者使用动态类型（快速实现）。

方式一：使用实体类（类型安全）

先定义一个和错误响应结构匹配的类，注意要和接口返回的JSON字段名严格对应（这里接口返回的是小写detail）：

using System.Text.Json.Serialization;

public class ErrorResponse
{
    [JsonPropertyName("detail")]
    public string Detail { get; set; }
}

然后在测试代码里完成断言：

// Act
response = await _httpClient.PostAsync("CompleteUserSetup", formContent);

// Assert
Assert.Equal(HttpStatusCode.BadRequest, response.StatusCode);

// 读取并反序列化错误响应
var errorContent = await response.Content.ReadAsStringAsync();
var errorResponse = JsonSerializer.Deserialize<ErrorResponse>(errorContent);

// 验证自定义错误信息
Assert.Equal("Username must be unique", errorResponse.Detail);

方式二：使用动态类型（快速实现）

如果不想额外定义类，也可以用动态类型解析JSON，不过这种方式没有类型检查：

// Act
response = await _httpClient.PostAsync("CompleteUserSetup", formContent);

// Assert
Assert.Equal(HttpStatusCode.BadRequest, response.StatusCode);

// 读取并解析JSON
var errorContent = await response.Content.ReadAsStringAsync();
dynamic errorResponse = JsonSerializer.Deserialize<dynamic>(errorContent);

// 验证错误信息（注意用小写的detail，和接口返回字段名一致）
Assert.Equal("Username must be unique", errorResponse.detail.ToString());

补充说明 #

• 如果你项目用的是Newtonsoft.Json（Json.NET），只需要把JsonSerializer.Deserialize换成JsonConvert.DeserializeObject即可，用法逻辑完全一致。
• 后续优化错误结构后，只需要调整实体类的结构，断言逻辑不需要大改。

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