使用AWS Java SDK v2获取MediaConvert端点时遇400 subscription maxResult错误

错误核心原因 #

你遇到的api.error.400.subscription.maxResult错误，是因为调用DescribeEndpoints时设置的maxResults参数超出了MediaConvert服务的允许范围。AWS官方规定该参数的有效值是1到10，但你的代码里写的是20：

DescribeEndpointsRequest.builder().maxResults(20).build()

这个参数错误才是触发400响应的根本原因，和应用启停时的连接清理操作无关。

为什么之前正常现在报错？ #

大概率是AWS近期对该接口的参数校验逻辑做了严格化调整，或者之前请求频率低，未触发严格校验；频繁启停程序导致请求量上升，触发了参数校验规则。

快速修复 #

把maxResults改成1-10之间的数值即可，考虑到你只需要第一个端点，直接设为1最高效：

DescribeEndpointsRequest.builder().maxResults(1).build()

关于客户端资源清理的说明 #

AWS Java SDK v2的客户端（比如MediaConvertClient）内部会自动管理连接池，不需要在应用关闭时专门清理端点连接。如果需要彻底释放客户端资源，可以调用mediaConvertClient.close()方法，但这不是解决当前错误的必要操作——当前问题完全是参数配置错误导致的。

内容的提问来源于stack exchange，提问作者user2989397