在Mac OS El Capitan上使用AWS SDK无法上传文件至S3的问题

我之前在Mac环境下也碰到过类似的AWS SDK上传卡住的情况，结合你的系统和Java版本信息，给你几个实用的排查和解决方向：

• 升级AWS SDK版本：旧版本的AWS Java SDK（尤其是1.x早期版本）和Mac OS El Capitan可能存在兼容性问题，比如线程池或NIO相关的阻塞bug。建议升级到最新的稳定版1.x（比如1.12.500），或者直接迁移到功能更完善的2.x SDK。如果用Maven管理依赖，更新依赖配置如下：

  <!-- 1.x SDK示例 -->
  <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-s3</artifactId>
      <version>1.12.500</version>
  </dependency>
  

• 显式关闭SDK客户端，释放后台线程：AWS SDK默认会创建后台线程（比如HTTP连接池线程），如果上传完成后没有主动关闭客户端，这些线程会一直存活导致程序无法退出。上传完成后一定要调用关闭方法：

  // 1.x SDK
  AmazonS3 s3Client = AmazonS3ClientBuilder.defaultClient();
  // 执行上传逻辑...
  s3Client.shutdown(); // 显式关闭客户端
  
  // 如果用TransferManager
  TransferManager tm = TransferManagerBuilder.standard().withS3Client(s3Client).build();
  Upload upload = tm.upload("bucketName", "fileKey", new File("path/to/file"));
  upload.waitForCompletion(); // 必须等待上传任务完成
  tm.shutdownNow(); // 关闭TransferManager
  

  另外可以用jstack <你的Java进程PID>命令查看线程状态，确认是否有阻塞的后台线程。

• 检查Mac防火墙与网络配置：El Capitan的防火墙可能对Java进程的网络访问有特殊限制，你可以临时关闭防火墙测试，或者在「系统偏好设置-安全与隐私-防火墙」中，确保Java进程被允许访问网络。同时检查是否有系统代理干扰，可在代码中显式禁用代理：

  System.setProperty("http.proxyHost", "");
  System.setProperty("http.proxyPort", "");
  System.setProperty("https.proxyHost", "");
  System.setProperty("https.proxyPort", "");
  

• 升级Java版本：你使用的Java 8u111版本较老，存在一些已知的网络相关bug，建议升级到Java 8的最新补丁版本（比如8u391），或者尝试替换为OpenJDK，很多开发者反馈替换后解决了Mac上的Java网络阻塞问题。

• 确认上传逻辑是否遗漏等待步骤：如果使用异步上传方式（比如TransferManager），一定要调用waitForCompletion()等待任务完成，否则程序会一直等待后台上传线程，看起来像是“卡住”了。

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