SoundWise 在接收视频输入时，通常会有文件大小和时长两道上限，但限制值并不是统一的，往往取决于软件版本、授权模式以及调用方是本地客户端还是服务端接口。排查时先别急着压缩文件，先看清错误出现在哪个环节：是上传被拒、转码失败，还是处理到一半中断。不同环节对应的限制来源不同，处理方式也不一样。
处理边界：先找到当前环境下的限制值，再核对视频本身的编码参数，最后根据错误信息区分是大小超限还是时长超限。若只是轻微超限，可压缩码率或分割视频后重试；如果限制来自授权或部署配置，则需要修改设置或申请更高权限。不要用清缓存、改临时目录这类方式绕过，因为那不是真正的解决路径。
先确认限制值从哪里来
SoundWise 的限制值一般写在三个地方：一是产品官网或软件包的说明页，注意看“规格”“技术参数”或“FAQ”部分；二是软件本身的设置面板，有的版本会直接给出百分比或数字提示；三是服务端接口文档，如果 SoundWise 是以 API 形式提供，错误码旁边通常有 limits 字段。对本地安装版，还可以查看安装目录下的配置文件，比如 soundwise.ini 或 application.yml，里面可能有 max_file_size_mb 和 max_duration_sec 这类参数。如果全部找不到，最直接的办法是拿一个已知的小文件测试，逐步增大文件大小或延长时长，观察在哪一步失败，从而反向推断限制值。
用 ffprobe 检查视频的实际参数
在排查前，先确认待处理视频的真实大小和时长，避免肉眼估算偏差。推荐使用 ffprobe 读取封装信息，命令如下：
ffprobe -v error -show_entries format=size,duration -of default=noprint_wrappers=1 input.mp4输出会显示类似 size=52428800（单位是字节）和 duration=611.500000（单位是秒）。如果系统里没有 ffprobe，也可以使用 Mediainfo 查看，macOS 上还可以直接空白键预览后查看“更多信息”。注意时长有时会被工具四舍五入，如果只差零点几秒就超限，可以用 -show_entries format=duration -of csv=p=0 取精确值。如果视频是可变帧率或存在损坏的尾部，时长可能显示异常，这种情况也要先修复再上传。
根据错误信息判断是大小还是时长限制
错误信息是定位限制类型的最快入口。常见的提示包括：File too large、Max file size exceeded 指向大小限制；Video duration exceeds the limit、Max duration exceeded 指向时长限制。还有一种容易被忽略的是 Resource exhaustion 或 Out of memory，这通常不是功能限制，而是服务器可用内存或磁盘不足，可能需要降码率而不是改大小。如果前端只是返回一个通用错误码，就要去查看后端日志。本地客户端可以查看 logs 目录下的 soundwise.log 文件，服务端则检查运行环境的 stdout 或集中日志。日志中一般会记录请求参数和具体拒绝原因，比如 invalid_media_file_size 或 invalid_duration。
处理：压缩码率或分割视频
如果确认是大小超限，在保持时长不变的情况下，可以通过降低视频码率来缩小文件。使用 ffmpeg 压缩的示例：
ffmpeg -i input.mp4 -b:v 2M -b:a 128k -c:v libx264 -c:a aac output.mp4如果时长超限，则建议分割视频。无转码分割速度快，但切割点可能不准；如果需要精确按时长切分，可以使用：
ffmpeg -i input.mp4 -f segment -segment_time 600 -c copy part_%03d.mp4这条命令会按每 600 秒一段生成多个文件，-c copy 表示不重新编码。分割后再逐个传入 SoundWise 验证。注意分段处理可能会影响后续的上下文分析，如果业务上需要完整视频，就不要用分割方案，而是改走上传更大文件的通道。压码率后要目测画质是否可接受，因为 2M 码率对不同分辨率来说画质差异很大，也不能保证一定能压缩到目标大小，可以先用 -fs 参数限定输出文件大小，例如 -fs 50M，让 ffmpeg 在达到目标前自动停止。
处理完成后，重新执行上传或任务提交，观察是否通过。如果仍失败，逐项核对：文件大小是否真的小于限制值，时长是否包含封面、黑帧等无效片段，容器格式是否为 SoundWise 支持的格式（mp4、mov 常见，但老版本可能不支持 HEVC）。最后可以做一个最小化验证：用一帧图片生成的视频或 3 秒短视频测试，确认工具本身没有问题，再逐步增加参数。
如果以上都做了仍无法通过，需要结合部署环境确认是否存在额外的网络传输超时、磁盘写入权限或账号配额限制。这部分限制通常不会写在软件说明里，只能通过日志或咨询管理员确认。整体思路是：先确定极限值，再对着参数逐一排查，而不是盲目反复上传。