为何KinesisClient.putRecord()无法识别有效的PutRecordRequest参数？

你的代码如下：

KinesisClient kinesisClient = KinesisClient.builder().build();
PutRecordRequest putRecordRequest = new PutRecordRequest();
putRecordRequest.setStreamName("stream-name");
putRecordRequest.setPartitionKey("SomeString-" + UUID.randomUUID());
putRecordRequest.setData(ByteBuffer.wrap(data));

PutRecordResponse putRecordResponse = kinesisClient.putRecord(putRecordRequest);

明明反编译jar包能看到putRecord(PutRecordRequest)方法，IDE也能自动补全，但编译/运行时提示无法解析该方法，可能的原因如下：

• 依赖版本不一致：项目中Kinesis SDK的编译依赖和运行依赖版本不匹配。比如编译时用了包含该方法的新版本，但运行环境里的旧版本jar包没有这个方法，或者反之。检查Maven/Gradle的依赖配置，确保各阶段的SDK版本统一。
• 类加载器冲突：项目中存在多个不同版本的Kinesis SDK jar包，类加载器加载了没有该方法的旧版本类。通过mvn dependency:tree或gradle dependencies查看依赖树，排除重复或冲突的依赖。
• 导入类错误：确认KinesisClient和PutRecordRequest的导入包是否正确，是否误导入了其他同名类（比如第三方封装类、旧版SDK类）。正确的导入应为：

  import software.amazon.awssdk.services.kinesis.KinesisClient;
  import software.amazon.awssdk.services.kinesis.model.PutRecordRequest;
  

• IDE缓存问题：IDE自动补全依赖缓存，但实际编译依赖已更新。清理IDE缓存（比如IntelliJ的File -> Invalidate Caches...）后重新构建项目。
• 方法签名不匹配：仔细核对反编译的方法签名和你调用的是否完全一致。比如是否存在重载方法，参数类型看似匹配但实际是不同包的同名类实例。
• Java模块系统限制（Java 9+）：若使用Java 9及以上模块系统，可能模块未正确导入Kinesis SDK包。检查module-info.java，确保添加requires software.amazon.awssdk.kinesis;语句。

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