参数校验日志记录有必要吗
你有没有遇到过这种情况：用户提交了一个表单，系统直接报错“服务器内部错误”，但开发人员查了半天也不知道具体是哪个字段出了问题？这时候，如果在参数校验时加了日志记录，可能几秒钟就能定位问题。
参数校验是程序运行的第一道防线。比如用户注册时填邮箱，如果格式不对，系统应当提醒“邮箱格式不正确”，而不是让程序崩溃。但这只是前端或基础校验，真正关键的是后端对输入数据的检查。而日志记录，就是把每次校验的过程和结果留下来。
为什么需要记录日志
想象一下快递员送件，每到一个站点都会扫描记录。如果包裹丢了，调出物流记录就知道卡在了哪一环。参数校验日志就像这个物流轨迹。比如某个接口突然频繁失败，查看日志发现大量“手机号格式错误”的记录，那可能是前端页面出了 bug，或者有恶意脚本在刷接口。
没有日志的情况下，排查问题只能靠猜。加了日志，问题发生后能快速看到是谁、什么时候、传了什么非法参数。这对维护系统稳定很实用。
实际场景中的例子
某电商系统有个优惠券领取接口，要求传用户ID和活动编号。某天运营反馈说很多人领不到，但开发本地测试没问题。查看参数校验日志后发现，大量请求的用户ID是空字符串，进一步追踪发现是App版本更新后，登录态处理逻辑变了，导致未登录用户也触发了领取请求。
如果没有日志，这个问题可能要花几天时间复现和猜测。有了日志，当天下午就定位并修复了。
怎么记录才合适
不是所有校验都要记日志。比如用户名不能为空这种基础检查，频繁记录会拖慢系统还占存储。重点记录那些可能反映异常行为的校验失败，比如：
- 参数类型不符（传了字符串却要数字）
- 值超出合理范围（年龄填了999）
- 必填字段缺失且来源可疑
记录时也不用写得太详细，避免泄露用户隐私。可以只记请求来源IP、接口名称、错误类型和时间。
2024-03-15 14:22:33 | IP: 192.168.1.100 | 接口: /api/user/profile | 错误: 参数"age"格式无效，期望整数，实际值"abc"这样的日志既够用又安全。
有些开发者觉得“校验失败直接返回就行，没必要记”。可现实是，线上问题往往发生在意想不到的地方。日志不是为正常流程服务的，而是为了在出问题时能快速反应。
特别是在团队协作或系统复杂度上升后，一个人不可能掌握所有细节。日志成了沟通的桥梁，让后来的人也能看懂系统曾经经历过什么。