Google Cloud LocalDatastoreHelper在Jenkins工作节点VM连接失败求助

看起来只有这一台Jenkins工作节点VM碰到了LocalDatastoreHelper的连接超时问题，其他节点和开发机都正常——这说明问题基本锁定在这台VM的环境差异上，而不是SDK或者代码本身的问题。结合你提供的堆栈（Socket连接超时）和使用的Google Cloud SDK 202.0.0、cloud-datastore-emulator 2.0.0版本，给你几个具体的排查方向：

1. 先排查网络层面的阻断 #

• 防火墙/安全组检查：对比其他正常节点的防火墙规则，确认这台VM是否允许访问Datastore emulator的端口（默认是8081，具体看你的emulator配置）。同时检查VM内部的本地防火墙（比如iptables、ufw），有没有拦截emulator端口的入站/出站请求。
• 连通性测试：在这台问题VM上执行以下命令测试网络连通：

  # 替换成你的emulator主机和端口
  telnet <emulator-host> <port>
  # 或者用nc更直观
  nc -zv <emulator-host> <port>
  

  如果测试失败，直接说明网络层面有阻断；如果emulator运行在本地，试试用127.0.0.1代替主机名，排查是不是DNS解析的问题。

2. 检查emulator进程和端口占用 #

• 确认Datastore emulator在这台VM上是否正常运行：

  ps aux | grep datastore
  

  如果进程不存在，说明emulator没有启动或者意外崩溃了；如果进程存在，继续检查端口是否被占用：

  # 替换成你的emulator端口
  lsof -i :<port>
  # 或者用netstat
  netstat -tulpn | grep <port>
  

  如果端口被其他进程占用，要么杀掉占用进程，要么修改emulator的端口配置。

3. 对比VM环境配置差异 #

• 把这台问题节点的环境变量和正常节点对比，重点检查和Datastore相关的变量：

  echo $DATASTORE_EMULATOR_HOST
  echo $GOOGLE_CLOUD_PROJECT
  

  看看有没有配置错误，比如主机名写错、端口不对的情况。
• 检查Java版本：不同Java版本对网络连接的处理可能有差异，执行java -version对比正常节点的Java版本是否一致。

4. 针对SDK版本的额外调试 #

• 你使用的SDK 202.0.0版本相对较旧，可以尝试临时升级到较新的SDK和emulator版本（注意先确认升级不会影响现有流程），看看能不能解决问题。
• 开启Datastore的调试日志，在这台VM上设置日志级别为DEBUG，获取更详细的连接失败细节，比如实际请求的地址、是否有异常的请求参数等。

你提供的堆栈跟踪： #

com.google.cloud.datastore.DatastoreException: Deadline exceeded Deadline exceeded java.net.SocketTimeoutException: connect timed out connect timed out java.net.SocketTimeoutException: connect timed out at java.net.PlainSocketImpl.socketConnect(Native Method) at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350) at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206) at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188) at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392) at java.net.Socket.connect(Socket.java:589) at sun.net.NetworkClient.doConnect(NetworkClient.java:175) at sun.net.www.http.HttpClient.openServer(HttpClient.java:463) at sun.net.www.http.HttpClient.openServer(HttpClient.java:558) at sun.net.www.http.HttpClient.<init>(HttpClient.java:242) at sun.net.www.http.HttpClient.New(HttpClient.java:339) at sun.net.www.http.HttpClient.New(HttpClient.java:357) at sun.net.www.protocol.http.HttpURLConnection.getNewHttpClient(HttpURLConnection.java:1220) at sun.net.www.protocol.http.HttpURLConnection.plainConnect0(HttpURLConnection.java:1156) at sun.net.www.protocol.http.HttpURLConnection.plainConnect(HttpURLConnection.java:1050) at sun.net.www.protocol.http.HttpURLConnection.connect(HttpURLConnection.java:984) at sun.net.www.protocol.http.HttpURLConnection.getOutputStream0(HttpURLConnection.java:1334) at sun.net.www.protocol.http.HttpURLConnection.getOutputStream(HttpURLConnection.java:1309) at com.google.api.client.http.javanet.NetHttpRequest.execute(NetHttpRequest.java:77) at com.google.api.client.http.HttpRequest.execute(HttpRequest.java:981) at com.google.datastore.v1.client.RemoteRpc.call(RemoteRpc.java:183) at com.google.datastore.v1.client.Datastore.commit(Datastore.java:87) at com.google.cloud.datastore.spi.v1.HttpDatastoreRpc.commit(HttpDatastoreRpc.java:153) at com.google.cloud.datastore.DatastoreImpl$4.call(DatastoreImpl.java:485) at com.google.cloud.datastore.DatastoreImpl$4.call(DatastoreImpl.java:482) at com.google.api.gax.retrying.DirectRetryingExecutor.submit(DirectRetryingExecutor.java:89) at com.google.cloud.RetryHelper.run(RetryHelper.java:74) at com.google.cloud.RetryHelper.runWithRetries(RetryHelper.java:51) at com.google.cloud.datastore.DatastoreImpl.commit(DatastoreImpl.java:481) at com.google.cloud.datastore.DatastoreImpl.commitMutation(DatastoreImpl.java:475) at com.google.cloud.datastore.DatastoreImpl.put(DatastoreImpl.java:435) at com.google.cloud.datastore.DatastoreHelper.put(DatastoreHelper.java:54) at com.google.cloud.datastore.DatastoreImpl.put(DatastoreImpl.java:410)

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