Rails调用Google Analytics GA4 API获取数据遇崩溃问题求助

问题根源 #

GRPC的Ruby客户端依赖C扩展实现，而Ruby的fork()会复制父进程线程状态，但GRPC内部的线程在子进程中无法正常工作，尤其在macOS的ObjC运行时环境下会触发线程异常。

解决方案 #

方案1：禁用GRPC的C扩展，改用纯Ruby实现 #

修改Gemfile，指定GRPC版本并调整加载逻辑：

gem 'grpc', '~> 1.50', require: false
gem 'grpc-tools', '~> 1.50'

在代码中强制加载纯Ruby版GRPC：

# 加载GA4库前设置环境变量，强制使用纯Ruby通道
ENV['GRPC_USE_RUBY_CHANNEL'] = '1'

require 'google/analytics/data/v1beta'

client = ::Google::Analytics::Data::V1beta::AnalyticsData::Client.new do |config|
  config.credentials = "config/google-api.json"
  # 额外配置：禁用keepalive减少线程冲突
  config.channel_args = {
    'grpc.keepalive_time_ms' => 0,
    'grpc.keepalive_timeout_ms' => 0
  }
end

hash = {"property": "properties/XXXXXXXXXX", "dimensions":[{"name":"date"}],"metrics":[{"name":"activeUsers"}],"date_ranges":[{"start_date":"2023-10-01","end_date":"2023-10-10"}]}

request = ::Google::Analytics::Data::V1beta::RunReportRequest.new hash

response = client.run_report request

方案2：在fork环境下重新初始化客户端 #

如果代码运行在fork场景（比如Rails服务器、Sidekiq），禁止复用父进程的GRPC客户端，子进程内重新创建实例：

# 父进程不提前初始化客户端，fork后在子进程内处理
if fork
  # 父进程逻辑
else
  ENV['GRPC_USE_RUBY_CHANNEL'] = '1'
  require 'google/analytics/data/v1beta'
  
  client = ::Google::Analytics::Data::V1beta::AnalyticsData::Client.new do |config|
    config.credentials = "config/google-api.json"
  end
  
  # 执行请求逻辑
  hash = {"property": "properties/XXXXXXXXXX", "dimensions":[{"name":"date"}],"metrics":[{"name":"activeUsers"}],"date_ranges":[{"start_date":"2023-10-01","end_date":"2023-10-10"}]}
  request = ::Google::Analytics::Data::V1beta::RunReportRequest.new hash
  response = client.run_report request
  exit
end

方案3：升级GRPC到最新稳定版 #

GRPC后续版本修复了部分fork相关的线程问题，执行升级命令：

bundle update grpc

升级后若仍有问题，结合方案1的环境变量设置即可。

验证步骤 #

1. 运行修改后的代码，检查是否还出现GRPC线程警告和崩溃
2. 确认GA4 API返回的数据正常，请求未被阻塞

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