用途:根据 API 的 OpenAPI(2.0、3.0、3.1、3.2)或 GraphQL 模式自动生成并运行测试,查找开发人员不会手写的边界值、非法类型、畸形载荷、深层嵌套等用例。安装:pip install schemathesis(提供 schemathesis 命令及别名 st),或用 uvx schemathesis run 免安装运行;Docker 镜像为 schemathesis/schemathesis:stable。
主要能力:按 Examples、Coverage、Fuzzing、Stateful 四个阶段执行;内置检查包括 5xx 错误、未记录状态码、响应模式违规、接受非法输入、忽略认证等;失败用例会缩减为最小输入并给出可复现的 curl 命令。支持 --auth、--header 认证,--include-path、--include-method 等选择目标操作,--max-examples、--phases、--checks、--workers、--rate-limit、--request-timeout、--max-response-time、--seed 控制规模,--report junit,har 等输出到 schemathesis-report/。配置可写入项目根目录 schemathesis.toml。支持 Python API(schemathesis.openapi.from_url、@schema.parametrize、call_and_validate、as_state_machine)配合 pytest 使用,以及 st replay 重放记录用例、--baseline 基线。
使用方式:示例命令 st run http://127.0.0.1:8000/openapi.json、st run ./openapi.yaml --url http://127.0.0.1:8000、st run http://127.0.0.1:8000/graphql;全部检查通过时退出码为 0,检查失败为 1,命令行错误为 2。
限制:不自行发送攻击载荷;不确认漏洞可利用性,500 错误需人工分诊;模糊测试会真实创建、修改、删除数据,应先在预发布或开发环境验证,不得未经授权对生产 API 测试;--workers 过多可能压垮目标,建议先用较低 --max-examples(50-100);模式须保持最新,否则结果可能误导;报告文件可能含响应体,应视为敏感数据;Schemathesis 4 与 3 的命令行和 Python API 有重命名差异。其他细节以官方资料为准,暂未提供的部分不做推测。