为什么fastapi这个json不显示标题啊

Question

我查看他的文档他的field（title=“”）写完后可以在网页的schema显示一段提示文字但我这个怎么搞都不行

Answer 1

以下回复参考：皆我百晓生、券券喵儿等免费微信小程序作答:

从你提供的代码和描述来看，FastAPI 的 schema 应该显示标题（title）的注释。如果它不显示标题，可能是由于以下几个原因：

1. 代码格式问题：确保你的代码格式正确，特别是类定义和字段定义部分。从你提供的代码来看，似乎有一些语法错误和不规范的空格和字符。例如，“图1内容如下：”部分的代码看起来不完整，且格式不规范。请确保你的实际代码是完整的并且遵循正确的格式。
2. 使用 schema_extra 的方式：FastAPI 使用 schema_extra 来添加额外的 schema 信息，例如示例值或描述。你应该确保 schema_extra 是作为 BookRequest 类的一部分定义的，并且格式正确。例如：

from pydantic import BaseModel, Field

class BookRequest(BaseModel):
    id: int = Field(title='ID')
    title: str = Field(min_length=1, title='书籍标题')
    author: str = Field(min_length=1, title='作者')
    description: str = Field(min_length=1, max_length=100, title='书籍描述')
    rating: int = Field(gt=-1, lt=10, title='评分')

class Config:
    schema_extra = {
        'example': {
            'title': '一本新书',
            'author': '夜冥',
            'description': '这是一本新书介绍',
            # 其他字段的示例值...
        }
    }

注意 schema_extra 应该是一个字典，其中 'example' 键用于定义示例值。标题（title）作为每个字段的一部分自动显示在 schema 中。 3. 依赖项和版本问题：确保你使用的 FastAPI 和 Pydantic 库版本是最新的，或者至少是与你的代码兼容的版本。有时旧版本的库可能会导致某些功能不正常。 4. 查看文档和示例：FastAPI 的文档和示例是非常有用的资源。如果你遇到问题，可以参考官方文档或搜索相关的教程和示例来解决问题。

如果以上建议都不能解决你的问题，请提供更详细的代码和错误信息，以便更准确地诊断问题所在。