在 FastAPI 中，如果你需要校验某个字段是否为有效的 URL 格式，可以使用 `pydantic` 提供的 `HttpUrl` 类型。FastAPI 依赖于 `pydantic` 进行数据验证和序列化，因此可以直接使用 `HttpUrl` 来校验传入的表单数据是否符合 URL 的格式。 以下是一个完整的示例代码，展示如何通过 `Form` 接收一个 URL 字段并进行校验： ```python from fastapi import FastAPI, Form, HTTPException from pydantic import HttpUrl, ValidationError from typing import Optional app = FastAPI() @app.post("/submit-url/") async def submit_url(url: str = Form(...)): try: # 使用 HttpUrl 校验 URL 格式 validated_url = HttpUrl(url) return {"message": "URL is valid", "url": validated_url} except ValidationError as e: # 如果校验失败，返回错误信息 raise HTTPException(status_code=400, detail="Invalid URL format") ``` ### 上述代码解释： 1. **导入模块**： - `FastAPI`: 主框架。 - `Form`: 用于接收表单数据。 - `HttpUrl`: 用于校验 URL 格式的工具。 - `ValidationError`: 捕获校验异常。 - `HTTPException`: 用于抛出 HTTP 错误响应。 2. **定义接口**： - `/submit-url/` 是一个 POST 接口。 - 接收一个名为 `url` 的表单字段，类型为字符串。 3. **校验逻辑**： - 使用 `HttpUrl` 对传入的字符串进行校验。 - 如果校验成功，返回校验后的 URL。 - 如果校验失败，捕获 `ValidationError` 并抛出 `400 Bad Request` 错误。 --- ### 注意事项： - `HttpUrl` 不仅会校验 URL 的格式，还会检查协议（如 `http://` 或 `https://`）是否正确。 - 如果你需要更复杂的校验（如特定域名或路径），可以在校验后添加自定义逻辑。 --- ### 示例请求与响应： #### 请求： ```bash curl -X POST "http://127.0.0.1:8000/submit-url/" \ -H "Content-Type: application/x-www-form-urlencoded" \ --data "url=https://example.com" ``` #### 响应（有效 URL）： ```json { "message": "URL is valid", "url": "https://example.com" } ``` #### 响应（无效 URL）： ```json { "detail": "Invalid URL format" } ``` --- ###