FastAPI接口测试：断言RequestValidationError未抛出的问题排查

问题原因 #

FastAPI的TestClient默认会将服务器抛出的异常转换为对应的HTTP响应（比如验证错误会返回422状态码），而不是直接在测试代码中抛出异常。所以你调用test_client.post时，不会触发RequestValidationError，导致assertRaises断言失败。

解决方案 #

方案一：验证HTTP响应（推荐） #

这是测试HTTP接口的标准做法，关注接口返回的状态码和响应内容，而非服务器内部异常：

response = test_client.post(url=url, headers=headers, json=json)
# 验证状态码为422（请求验证错误）
assert response.status_code == 422
# 可选：验证响应体中的错误细节
error_details = response.json()["detail"]
assert len(error_details) > 0
# 可进一步校验具体错误字段和提示信息
assert error_details[0]["loc"] == ["body", "your_field_name"]
assert error_details[0]["msg"] == "expected error message"

方案二：强制TestClient抛出服务器异常 #

如果一定要用assertRaises捕获异常，可以在创建客户端或发起请求时设置raise_server_exceptions=True：

# 方式1：创建TestClient时全局设置
test_client = TestClient(app, raise_server_exceptions=True)

# 方式2：单个请求时临时设置
with self.assertRaises(fastapi.exceptions.RequestValidationError):
    test_client.post(
        url=url,
        headers=headers,
        json=json,
        raise_server_exceptions=True
    )

注意：方案二更偏向于测试服务器内部逻辑，而方案一更贴近真实客户端与接口的交互场景，推荐优先使用方案一。

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