Java调用Amazon Connect实现语音功能的方法及连接报错处理

1. 区域查找失败异常修复 #

异常信息：com.amazonaws.SdkClientException: Unable to find a region via the region provider chain. Must provide an explicit region in the builder or setup environment to supply a region.

该异常是代码区域配置逻辑错误导致：AWS Java SDK 不支持客户端实例构建完成后调用setRegion方法配置区域，该配置在多数版本中不生效，SDK会走默认区域提供链查找区域，找不到即抛出异常。
正确配置方式是将区域声明放在Builder构建阶段，修改后代码如下：

BasicAWSCredentials basicAWSCredentials = new BasicAWSCredentials("accessKey", "secretKey");
AmazonConnectClient amazonConnectClient = (AmazonConnectClient) AmazonConnectClientBuilder.standard()
        .withCredentials(new AWSStaticCredentialsProvider(basicAWSCredentials))
        // 构建客户端时直接指定区域
        .withRegion(Regions.US_EAST_1)
        .build();

StartOutboundVoiceContactResult voiceContactResult = amazonConnectClient.startOutboundVoiceContact(awsVoiceRequest);
System.out.println(voiceContactResult.getContactId());
System.out.println(voiceContactResult.getSdkResponseMetadata().toString());

2. 服务端点连接超时异常排查 #

异常信息：com.amazonaws.SdkClientException: Failed to connect to service endpoint: ，底层为java.net.SocketTimeoutException: connect timed out

该异常为网络层面无法连通Amazon Connect服务端点导致，按以下步骤排查：

• 确认代码中指定的区域（示例中为us-east-1）已开通Amazon Connect服务，且你创建的Amazon Connect实例归属区域和代码指定区域一致
• 排查运行环境网络限制：
  • 公网环境运行时，确认防火墙、安全组未限制对外访问443端口，无需代理的场景下检查是否误配置了全局代理
  • VPC内网环境运行时，确认已配置Amazon Connect的VPC端点，或存在可访问公网AWS服务的NAT网关
• 确认使用的AccessKey、SecretKey对应的IAM身份已配置connect:StartOutboundVoiceContact权限，且资源范围包含你的Amazon Connect实例ID

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