ZLMediaKit项目中时间参数导致HTTP 415错误的排查与解决

在视频监控系统的开发过程中，我们经常会遇到各种接口调用问题。本文将分享一个在ZLMediaKit项目中遇到的典型问题：使用Feign客户端调用视频回放接口时出现HTTP 415 Unsupported Media Type错误，而通过Postman直接调用却正常的案例。

问题现象

开发团队在实现视频回放功能时发现，通过Feign客户端调用视频回放接口时，摄像头返回415错误，提示不支持的媒体类型。而使用Postman直接请求相同的接口却能正常播放视频。经过初步分析，发现两者的主要区别在于请求参数：回放接口需要传递开始和结束时间参数。

深入分析

接口定义对比

回放接口和实时流接口的主要区别在于参数结构。实时流接口只需要设备ID等基本信息，而回放接口额外需要两个时间参数：

private LocalDateTime beginRecordTime;
private LocalDateTime endRecordTime;

时间格式验证

通过调试发现，无论是Feign调用还是Postman请求，时间格式都符合ISO标准（如2025-04-24T12:10:55），表面上看格式没有问题。但深入日志分析后发现了差异：

1. Feign调用时，虽然时间值正确，但可能在序列化过程中产生了微妙的差异
2. 时间参数的时区处理可能存在不一致
3. 时间范围可能超出了设备支持的范围

日志分析关键点

从系统日志中可以看出几个重要线索：

1. SIP协议层显示设备拒绝了请求
2. 媒体服务器(ZLM)日志中缺少预期的流注册记录
3. 回放流相比实时流有特殊的生命周期管理（自动关闭问题）

问题根源

经过仔细排查，最终确定问题根源不在媒体类型上，而是请求的时间范围超出了设备支持的范围。具体表现为：

1. 设备固件对时间范围有严格限制
2. 超出限制时设备返回的415错误具有误导性
3. 时间参数在序列化/反序列化过程中可能丢失精度

解决方案

针对这个问题，我们采取了以下解决措施：

1. 增加时间范围校验：在业务逻辑层添加对时间范围的预校验
2. 改进错误处理：将设备返回的415错误转换为更有意义的业务异常
3. 日志增强：在关键节点增加详细的请求参数日志
4. 接口文档完善：明确标注时间参数的格式和有效范围

经验总结

这个案例给我们几个重要的启示：

1. 不要盲目信任错误代码：415错误表面上是媒体类型问题，实际可能是业务逻辑问题
2. 全链路日志的重要性：从客户端到服务端再到设备的完整日志链对排查问题至关重要
3. 时间处理要谨慎：在分布式系统中，时间参数的序列化和时区处理需要特别关注
4. 设备兼容性考虑：不同厂商设备对协议的实现可能有差异，需要做好兼容处理

通过这次问题的排查，团队不仅解决了当前的功能障碍，还建立了一套更完善的视频接口开发和调试规范，为后续开发工作打下了良好基础。