AWS Neptune reader endpoint访问超时 主端点可正常连通问题排查

1. 只读端点本身配置与状态异常 #

• 确认只读端点绑定的reader实例是否处于Available状态，是否存在实例重启、规格不足、后台维护任务占用资源的情况，部分新版Neptune引擎的只读实例初始化未完成时会出现无响应的问题，可尝试重启对应reader实例验证。
• 确认只读端点的安全组规则与主端点一致：检查是否放行访问来源的8182端口（Gremlin默认服务端口），IAM访问策略是否对只读端点做了单独限制，部分场景下管理员会针对主/读端点配置不同的鉴权规则。

2. 网络链路配置差异 #

• 检查Transit Gateway路由表配置：确认只读端点所属的可用区子网CIDR段已加入K8s集群所在VPC的可达路由，主端点和只读端点可能部署在不同可用区子网，若仅配置了主端点所在子网的路由，就会出现主端点可访问、只读端点超时的问题。
• 验证DNS解析正确性：在本地、K8s Pod、远程服务器上分别执行nslookup <Neptune只读端点域名>，确认解析出的IP属于Neptune集群VPC内网网段，不存在解析错误、DNS劫持的情况。
• 确认公网访问属性配置：如果是从本地公网发起访问，需确认只读端点和主端点一样开启了公网访问权限，Neptune默认不会为只读端点自动开启公网访问。

3. Gremlin驱动兼容问题 #

• 你使用的Gremlin 3.4.10版本存在已知的Neptune只读端点兼容问题：3.4.x部分版本的gremlin-java驱动连接只读端点时，默认会协商写权限相关参数，未显式配置只读模式时会导致握手超时，可尝试在客户端配置中添加.enableReadOnly(true)参数，或者将驱动升级到3.4.14以上的兼容版本验证。
• 检查客户端超时配置：只读端点跨可用区访问时延迟会高于同可用区的主端点，若之前针对主端点配置的超时阈值过低，也会触发只读端点访问超时，可临时将超时参数调整到10s以上验证连通性。

4. 集群级配置限制 #

• 检查Neptune参数组配置：确认neptune_read_only参数未被异常修改，同时确认是否针对只读实例配置了连接数限制、QPS限流规则，超出阈值后新连接会被丢弃导致超时。
• 验证跨账号访问权限：如果Neptune集群和K8s集群属于不同AWS账号，需确认资源访问策略同时放开了主端点和只读端点的访问权限，部分默认权限配置仅会放开集群主端点的访问权限。

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