使用Fixie配置静态IP实现Heroku应用连接MongoDB Atlas时出现请求超时

1. 优先校验代理配置的实际生效状态 #

• 检查Heroku应用的环境变量：绑定Fixie插件后，平台会自动注入格式为FIXIE_URL的代理连接串，如果对应配置缺失，说明插件未正确关联当前应用，需解绑后重新绑定插件。
• 排除代码层面的代理绕过问题：部分配置仅在普通Web请求逻辑中挂载了代理，没有给MongoDB连接逻辑配置代理参数，这种情况下应用发起的数据库请求会直接直连Atlas，完全不经过Fixie链路，自然不会在Fixie控制台留下请求日志，Atlas因为收不到Fixie静态IP的请求，最终表现为连接超时。
• 特别提醒：NodeJS生态的MongoDB官方驱动、Mongoose类库默认不会自动继承全局HTTP/HTTPS代理环境变量，和普通Web请求的代理逻辑完全不兼容，仅配置全局代理参数对数据库连接无效。

2. 修正MongoDB连接的代理适配配置 #

• 不要直接复用普通Web请求的代理配置参数给MongoDB连接，需要在MongoDB的连接选项中显式传入代理对应的主机、端口参数，匹配Fixie对长TCP连接的代理规则。
• 避免端口配置错误：Fixie对普通HTTP请求和TCP类长连接（比如MongoDB）提供的代理端口是不同的，如果误用HTTP端口转发数据库连接，Fixie会直接丢弃请求包，不会生成任何日志记录。

3. 排查Heroku与Fixie的路由链路匹配问题 #

• 通过Heroku命令行进入应用运行环境的Shell，分别测试两条链路的连通性：
  • 从dyno环境直接向Fixie代理地址发起连通性测试，确认dyno到Fixie代理节点的网络可达，未被Heroku出站网络策略拦截
  • 从dyno环境通过Fixie代理向MongoDB Atlas集群节点发起连通性测试，确认代理转发链路无丢包
• 检查Fixie的路由绑定规则：部分插件版本会按Heroku应用的运行时类型匹配转发路由，如果你的应用运行在专用运行时环境，而Fixie默认仅绑定通用运行时的出口规则，就会出现应用请求完全不经过Fixie的问题，需要在Fixie控制台调整路由绑定范围，匹配当前应用的实际运行环境。

4. 排除MongoDB Atlas端的配置偏差 #

• 确认添加到Atlas IP白名单的地址，是Fixie为当前应用分配的专属静态出口IP，而非账号级的共享IP段，共享IP段会被Atlas的安全策略判定为不可信来源直接拦截。
• 打开Atlas的连接审计日志，通过超时请求的来源IP定位链路位置：
  • 如果日志中显示的请求来源是Heroku的动态出站IP，说明请求完全未走Fixie代理，需重点回溯驱动的代理配置
  • 如果日志中无任何连接请求记录，说明请求在到达Atlas前已被中间链路拦截，需重点调整Fixie的转发规则

内容的提问来源于stack exchange，提问作者A.Shoman