Skip to content

最佳实践 - 参数校验

image-20250110125946771

基本参数管理与校验

  • 🔒 同一参数字段,在不同接口中应保持统一的最大长度限制,并且确保与数据库中的最大长度相匹配。
  • ✅ 对所有请求参数使用注解的方式进行全面校验,包括但不限于非空、长度及取值范围,。
  • 💼 若输入参数过多,则考虑将它们封装进单一对象内来简化管理。

安全性校验

  • 🔍 查询接口除了基本校验外,还需验证用户状态等信息。

测试与质量保证

  • 👷‍♂️ 编码完成后,自行测试参数校验逻辑,以发现潜在问题。

文档与维护

  • 📝 为每一个参数提供注释,以便他人理解维护。

  • 📄 接口变更需及时更新至接口文档,保证文档的一致性和完整性。