Django Ninja v1.4.0 版本发布：文件上传优化与验证增强

Django Ninja 是一个基于 Django 的现代 Web API 框架，它结合了 Django 的稳定性和 FastAPI 的现代化特性，为开发者提供了高性能、易用的 API 开发体验。最新发布的 v1.4.0 版本带来了一系列重要改进，特别是在文件上传处理、验证错误自定义和性能优化方面。

文件上传功能增强

在之前的版本中，Django Ninja 在处理非 POST 请求（如 PUT、PATCH）时存在一个常见问题：request.FILES 不会被自动填充。这导致许多开发者在实现文件上传 API 时遇到验证失败的问题，不得不手动添加中间件来解决。

v1.4.0 版本对此进行了改进，现在当用户使用非 POST 方法时，Django Ninja 会自动检测并提示用户需要添加相应的中间件。这一改进显著提升了开发体验，减少了配置上的困惑。

分页性能优化

分页功能在这个版本中得到了两方面的增强：

1. 异步视图性能提升：针对异步视图的分页操作进行了专门优化，提高了处理大量数据时的响应速度。

2. DRF 风格的分页参数：新增了对 page_size 参数的支持，这与 Django REST Framework 的分页行为保持一致，使得从 DRF 迁移过来的开发者能够更轻松地适应。

验证错误处理改进

验证错误处理机制在这个版本中变得更加灵活：

• 验证失败现在会抛出 ninja.errors.ValidationError（注意与 pydantic.ValidationError 区分）
• 默认异常处理器会返回 422（Unprocessable Content）状态码和标准化的错误响应格式
• 新增了 validation_error_from_error_contexts 方法，允许开发者完全自定义验证错误的返回格式

正则表达式模式验证

v1.4.0 完全支持 Pydantic 的最新正则表达式模式验证功能，开发者现在可以在路径参数和查询参数中直接使用正则表达式进行额外验证：

@router.get("/path/param-pattern/{item_id}")
def get_path_param_pattern(request, item_id: str = Path(..., pattern="^foo")):
    return item_id

自定义 Django 模型字段支持

新增了标准化的方式来注册自定义 Django 字段到 Pydantic 类型：

from ninja.orm import register_field
register_field("MyCustomField", int)

这一功能使得集成项目中自定义的模型字段变得更加简单和规范。

节流功能增强

节流（Throttling）系统现在支持多周期间隔配置，例如：

• 5/30s：每30秒5次
• 10/5m：每5分钟10次
• 100/2h：每2小时100次

相比之前只支持单周期间隔（如 5/s、100/d），这一改进提供了更灵活的速率限制配置选项。

其他重要改进

1. 操作默认选项：允许为操作设置默认选项，简化了常见配置的重复设置。

2. IPNetwork 和 URL 序列化：新增了对这些特殊类型的序列化支持。

3. 认证错误区分：明确区分了身份验证错误（AuthenticationError）和授权错误（AuthorizationError），便于更精确的错误处理。

4. 测试工具增强：TestClient 现在支持 COOKIES，并改进了查询参数的处理方式。

总结

Django Ninja v1.4.0 版本在保持框架简洁性的同时，通过一系列实用改进增强了其功能和灵活性。特别是文件上传处理的优化、验证错误的自定义支持以及分页性能的提升，都将显著改善开发者的使用体验。对于正在寻找一个既保留 Django 优势又具备现代 API 框架特性的开发者来说，这个版本值得关注和升级。