使用google-cloud Node.js客户端向BigQuery插入数据失败，求环境排查

看起来你遇到的是典型的跨环境兼容性问题，我结合你的测试情况，梳理了几个最可能的环境因素，你可以逐一排查：

1. 依赖库版本不匹配 #

虽然你在Docker里切换到了Node v6.9.4，但如果两个环境中@google-cloud/bigquery的安装版本不一致，很可能导致问题：

• Node v4.x对npm包的兼容性和Node v6.x有不小差异，如果你最初在Ubuntu环境是基于Node v4安装的库，哪怕后来升级了Node，旧的依赖文件可能没被替换，残留了不兼容的版本。
• 你可以在Mac和Ubuntu/Docker里分别执行npm list @google-cloud/bigquery查看版本号，确保完全一致。如果版本不同，在Ubuntu/Docker里重新安装对应版本：

  npm uninstall @google-cloud/bigquery
  npm install @google-cloud/bigquery@<你Mac上的版本号>
  

2. 系统底层加密库（OpenSSL）版本差异 #

Google Cloud的客户端库依赖OpenSSL处理HTTPS请求，Ubuntu和Mac默认的OpenSSL版本可能存在差异：

• 旧版本的Ubuntu（比如16.04及更早）自带的OpenSSL版本偏老，可能不支持客户端库需要的TLS协议版本，导致请求无法正常建立连接，但又没抛出明确的错误。
• 你可以在两边分别执行openssl version对比版本，如果Ubuntu这边版本过低，要么升级系统的OpenSSL，要么切换到更新的Ubuntu基础镜像（比如20.04+）来构建Docker容器。

3. Docker容器的工作目录和文件路径问题 #

虽然你排除了认证问题，但Docker容器的工作目录可能和你预期的不一样：

• 代码里用的./google-cloud-auth.json是相对路径，如果Docker启动时的工作目录不是你放置文件的目录，客户端库其实找不到认证文件，但有些旧版本的库不会抛出明确的找不到文件错误，只会返回空的错误对象和undefined响应。
• 建议你要么在代码里用绝对路径指定认证文件，要么启动容器时通过-w参数指定正确的工作目录，比如：

  docker run -w /app -v $(pwd):/app 你的容器镜像名
  

  同时可以在代码里加一行打印当前工作目录的代码确认：

  console.log('当前工作目录:', process.cwd());
  

4. 网络访问限制 #

Ubuntu机器或者Docker容器可能存在网络代理、防火墙或者DNS解析问题，导致无法正常连接BigQuery的API：

• 先在Ubuntu机器上测试连通性，执行ping bigquery.googleapis.com或者curl https://bigquery.googleapis.com/看看能不能正常访问。
• 如果是Docker容器的问题，检查是不是用了自定义网络，或者容器的DNS设置有问题，可以尝试启动容器时加上--dns 8.8.8.8参数强制使用Google DNS试试。

5. 系统时间不同步 #

BigQuery对请求的时间有效性有要求，如果Ubuntu/Docker的系统时间和实际时间偏差太大，可能会导致请求被静默拒绝：

• 在Ubuntu里执行date命令看看时间，对比Mac上的时间，确保差异在几分钟以内。如果时间不同步，安装并配置ntp服务来同步时间：

  sudo apt-get install ntp
  sudo systemctl start ntp
  

6. Docker镜像缺少必要的系统依赖 #

有些精简版的Docker基础镜像（比如Alpine或者最小化Ubuntu）没有预装CA证书这类基础依赖，导致HTTPS请求无法验证服务器证书，最终请求静默失败：

• 如果你的Docker用的是这类镜像，可以在Dockerfile里添加安装CA证书的步骤：

  RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
  

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