FastAPI中使用Pydantic field_validator验证非localhost URL时异常行为不符预期的问题

我太懂这种卡壳的感觉了——用了好几年的工具突然出了莫名其妙的问题，尤其是验证逻辑这种本该顺畅的环节，确实闹心。让我帮你拆解一下你遇到的问题，以及怎么解决它。

首先看你代码里的几个关键问题：

• 拼写错误坑：你写的pydantic.ValidaionError少了一个字母t，正确的应该是pydantic.ValidationError。这个拼写错误直接导致了后续的AttributeError，因为Pydantic根本识别不了这个错误类，进而搞砸了模型实例化的流程，才会出现“WebhookData没有webhook_url属性”的奇怪提示。
• 错误的异常抛出方式：哪怕拼写对了，直接抛出ValidationError也是不对的。这个异常类需要配合特定的错误信息结构来实例化，不能直接裸抛。在Pydantic的field_validator里，你只需要抛出普通的ValueError（或者TypeError、AssertionError这类标准异常），Pydantic会自动把它包装成符合规范的验证错误，再传递给FastAPI转换成422响应。
• 为什么抛ValueError时出现TypeError？
  大概率是因为你代码里的Event类没有正确定义——如果Event不是Pydantic的BaseModel，也没有做对应的类型注解处理，FastAPI在解析list[Event]这个字段时会出问题，进而干扰了webhook_url验证器的异常处理流程，才会出现预期外的TypeError。

接下来给你修正后的完整代码示例，你可以直接参考：

import pydantic
from pydantic import BaseModel, HttpUrl, field_validator
from fastapi import FastAPI, Request, APIRouter

router = APIRouter()

# 先确保Event是正确的Pydantic模型（如果之前不是的话）
class Event(BaseModel):
    # 这里根据你的实际需求添加字段，比如：
    event_type: str
    timestamp: int

class WebhookData(BaseModel):
    webhook_url: HttpUrl
    events: list[Event]

    @field_validator("webhook_url", mode="after")
    @classmethod
    def is_not_local_host(cls, url: HttpUrl):
        # 这里可以考虑同时排除127.0.0.1之类的本地地址，按需调整
        if url.host and "localhost" in url.host:
            raise ValueError("localhost values are not allowed")
        return url

@router.post("/test2")
async def enable_webhook(request: Request, data: WebhookData):
    # 替换成你的实际业务逻辑
    return {"status": "success", "webhook_url": str(data.webhook_url), "events_count": len(data.events)}

最后解释一下为什么在FastAPI路由里验证器的异常行为看起来“不一样”：
FastAPI和Pydantic是深度绑定的，当你把Pydantic模型作为请求体参数时，FastAPI会接管Pydantic的验证流程，自动收集所有验证错误，整理成符合规范的422响应。但如果你的验证器抛出了Pydantic无法识别的异常（比如拼写错的ValidationError、构造错误的异常对象），或者其他字段的验证先出了问题，就会打破这个流程，导致未被捕捉的异常泄漏出来，表现成你看到的TypeError或者AttributeError。

只要按照上面的修正，确保抛出正确的异常、修正拼写错误、正确定义所有嵌套模型，验证器就会正常工作，localhost的请求会被正确拦截并返回422状态码。

内容来源于stack exchange