Node.js连接AWS Neptune遇ETIMEDOUT错误求助

针对你遇到的connect ETIMEDOUT错误，按以下步骤逐一排查：

1. 网络连通性验证 #

• 确认Node.js应用所在环境（EC2、本地、容器等）与Neptune实例的网络可达性：
  • 若应用在AWS内部，必须和Neptune处于同一个VPC，或通过VPC对等连接、VPN网关打通网络；
  • 若应用在本地，需开启Neptune的公网访问权限（Neptune控制台→实例→连接→编辑公网访问），同时确保本地网络能访问AWS公网端点。
• 在应用所在环境执行端口连通测试：

  telnet db-neptune-1-instance-1.crgy0cuiqvqy.ap-southeast-2.neptune.amazonaws.com 8182
  # 或用nc
  nc -zv db-neptune-1-instance-1.crgy0cuiqvqy.ap-southeast-2.neptune.amazonaws.com 8182
  

  若测试失败，直接定位到网络/安全组问题，无需继续排查代码。

2. 安全组配置检查 #

• Neptune入站规则：必须添加允许应用来源（IP地址或安全组ID）访问8182端口的规则。例如：
  • 来源设为应用所在EC2的安全组ID（同VPC场景）；
  • 来源设为本地公网IP（本地测试场景）。
• 应用所在环境出站规则：确保允许向8182端口发起出站请求。

3. IAM认证配置（若启用） #

如果Neptune开启了IAM数据库认证，连接代码必须携带签名，否则会被拒绝或超时：

• 安装AWS SDK依赖（若未安装）：

  npm install aws-sdk
  

• 修改连接代码添加IAM认证：

  const gremlin = require("gremlin");
  const DriverRemoteConnection = gremlin.driver.DriverRemoteConnection;
  const Graph = gremlin.structure.Graph;
  const iamAuth = gremlin.driver.auth.iamAuth({
    region: "ap-southeast-2",
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
  });
  
  dc = new DriverRemoteConnection(
    "wss://db-neptune-1-instance-1.crgy0cuiqvqy.ap-southeast-2.neptune.amazonaws.com:8182",
    { auth: iamAuth }
  );
  
  const graph = new Graph();
  const g = graph.traversal().withRemote(dc);
  
  // 后续查询代码不变
  

• 确保IAM角色/用户拥有neptune-db:Connect权限。

4. 连接参数与版本兼容 #

• 增加连接超时时间，避免因网络延迟导致超时：

  dc = new DriverRemoteConnection(
    "wss://db-neptune-1-instance-1.crgy0cuiqvqy.ap-southeast-2.neptune.amazonaws.com:8182",
    { connectionTimeout: 30000 } // 30秒超时
  );
  

• 验证Gremlin库版本与Neptune版本兼容：Neptune对Gremlin版本有严格要求，例如Neptune 1.2.x对应Gremlin 3.5.x，版本不匹配会导致连接失败。可在Neptune控制台查看实例版本，调整gremlin包版本。

5. 临时测试方案（本地调试） #

若本地测试困难，用AWS CLI端口转发绕过公网限制：

aws neptune-db connect-db-cluster --db-cluster-identifier db-neptune-1 --region ap-southeast-2 --port 8182 --local-port 8182

然后将代码中的端点改为wss://localhost:8182，若能成功连接，说明原问题出在网络/安全组配置。

内容的提问来源于stack exchange，提问作者حمزہ لیاقت