Proxy导致send SMS功能无法正常工作问题排查咨询

常见代码错误排查点 #

• 代理未显式绑定到短信请求客户端：绝大多数HTTP客户端、短信SDK不会自动读取系统全局代理配置，仅在系统层面设置代理环境变量不会生效，必须在初始化发送请求的客户端实例时，显式传入代理地址、端口、鉴权参数。
  以Python requests库为例，正确的传参写法：

  import requests
  # 代理配置，注意区分http/https协议对应配置
  proxy_config = {
      "http": "http://代理账号:代理密码@代理地址:代理端口",
      "https": "http://代理账号:代理密码@代理密码@代理地址:代理端口"
  }
  # 发送请求时显式传入代理配置
  resp = requests.post(
      url="短信服务API地址",
      data={"手机号": "xxx", "短信内容": "xxx"},
      proxies=proxy_config,
      timeout=15
  )
  

  注意：如果代理账号、密码包含@、:等特殊字符，需要先做URL编码再写入配置，否则会出现代理鉴权失败。
• 代理协议配置不匹配：代理分为HTTP、HTTPS、SOCKS5等不同类型，代码中配置的代理类型必须和实际使用的代理类型一致，否则会出现连接超时、连接重置类报错。
• 代理访问规则限制：先通过命令行工具验证代理本身是否能访问短信服务接口，执行如下测试命令：

  curl -x 代理协议://代理地址:端口 -v 短信服务API地址
  

  若命令执行返回连接失败，说明代理本身未放通短信服务的访问权限，和代码逻辑无关。
• 超时阈值设置不合理：代理转发会增加网络链路长度，延迟比直连高2-10倍，若沿用直连场景下3s以内的短超时配置，请求会在代理转发完成前被主动中断，导致发送失败。

可行替代实现方案 #

• 同VPC短信中转方案：在和当前服务同私有网络的环境下，部署一台可直连短信服务网关的中转服务，当前服务通过内网将短信发送请求转发至中转节点，由中转节点完成实际发送。该方案比公网代理延迟低、稳定性高，可避免公网代理IP被封禁、鉴权失效等问题。
• 短信服务私网接入方案：主流云厂商短信服务均提供VPC私网接入端点，若当前服务部署在对应云厂商的云服务器/容器实例上，可直接切换到私网端点调用，完全不需要公网代理，链路稳定性最高。
• 消息队列异步解耦方案：将短信发送请求先投递到消息队列，在可直连短信网关的网络环境下部署消费者进程，拉取队列消息执行发送逻辑。该方案可解耦业务逻辑和短信发送能力，即使网络临时波动，消息也可持久化重试，不会丢失发送请求。

内容的提问来源于stack exchange，提问作者Anis Fatin Nabila Binti Ardhi