AWS SDK ProxyConfiguration类endpoint方法使用及校验说明

核心设计逻辑 #

这个校验是SDK做的前置快速失败（fail-fast）校验，本质原因是HTTP正向代理的连接规则里，代理端点本身只需要三个有效组成部分：协议（scheme，http/https）、主机地址（host，域名/IP）、端口（port），其余字段完全没有业务意义，还会引发配置冲突：

• 代理的工作模式是客户端先和代理服务的监听端口建立TCP连接，之后再把真实的业务请求（包含目标资源的path、query等信息）发送给代理，由代理完成转发。代理端点本身带path、query、fragment属于无效配置，代理服务在连接建立阶段根本不会识别这些字段，留着只会引发无意义的连接错误。
• 方法同时拦截URI中内嵌的userInfo（也就是user:password@host这种写法里的账号密码部分），是因为ProxyConfiguration已经单独提供了.username()、.password()方法用于配置代理认证信息，禁止内嵌userInfo是为了避免重复配置、认证逻辑解析冲突。
• 这类校验在配置阶段就拦截非法格式，比等到实际发起S3请求时才出现连接失败、认证失败问题更便于排查配置错误。

调用代码的配置注意事项 #

你当前的代码写法本身没有问题，只需要保证s3ProxyConfig.proxyEndpoint()返回的URI符合格式要求即可：

合法的代理端点格式示例 #

http://proxy.example.com:8080
https://10.0.0.12:3128

会触发校验报错的非法格式示例 #

// 错误：携带path
"http://proxy.example.com:8080/forward"
// 错误：在URI中内嵌账号密码
"http://proxyuser:proxypwd@proxy.example.com:8080"
// 错误：携带query或fragment
"http://proxy.example.com:8080?net=office#sec"

如果你的现有代理配置带path，需要确认是不是误把代理服务的业务接口路径当成了代理本身的监听地址，找网络运维确认代理服务的基础监听地址，去掉多余的path、query等部分即可正常使用。

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