Confluent Kafka Go包兼容Ubuntu22.04吗？升级后报错求解决

问题背景 #

此前在Ubuntu 20.04系统下使用Golang开发数据流服务器，依赖Confluent Kafka包可正常运行。升级至Ubuntu 22.04后，代码抛出一系列未定义错误：

• kafka.producer/producer.go:18:26: undefined: kafka.Producer
• kafka.producer/producer.go:35:17: undefined: kafka.ConfigMap
• kafka.producer/producer.go:40:30: undefined: kafka.NewProducer
• kafka.producer/producer.go:133:50: undefined: kafka.Message
• kafka.producer/producer.go:134:27: undefined: kafka.TopicPartition
• kafka.producer/producer.go:136:23: undefined: kafka.PartitionAny

同项目中的segmentio/kafka-go包可正常运行，但因Confluent包的subscribe/unsubscribe功能更贴合需求，需修复该问题。

修复方案 #

1. 修正Confluent Kafka包的导入路径 #

Confluent的Golang包已从旧路径迁移至新路径，旧路径依赖可能因系统升级后拉取的版本不兼容导致符号未定义。

• 修改代码中的导入语句为最新路径：

  import "github.com/confluentinc/confluent-kafka-go/v2/kafka"
  

• 执行依赖更新命令：

  go get -u github.com/confluentinc/confluent-kafka-go/v2/kafka
  go mod tidy
  

2. 更新系统级librdkafka依赖 #

Confluent Kafka Go包依赖系统的librdkafka库，Ubuntu 22.04默认版本可能与旧环境不兼容。

• 卸载旧版本：

  sudo apt remove --purge librdkafka-dev librdkafka1
  

• 添加Confluent官方源并安装最新版：

  sudo apt install -y wget gnupg2
  wget -qO - https://packages.confluent.io/deb/7.4/archive.key | sudo apt-key add -
  echo "deb [arch=amd64] https://packages.confluent.io/deb/7.4 stable main" | sudo tee /etc/apt/sources.list.d/confluent.list
  sudo apt update
  sudo apt install -y librdkafka-dev librdkafka1
  

• 重新编译项目：

  go build ./...
  

3. 重置Go模块依赖锁定 #

若go.mod或go.sum锁定的包版本异常，会导致符号不匹配：

• 删除旧依赖条目并重新拉取：

  go get github.com/confluentinc/confluent-kafka-go/v2/kafka
  go mod tidy
  

• 也可指定兼容版本（以v2.2.0为例）：

  go get github.com/confluentinc/confluent-kafka-go/v2/kafka@v2.2.0
  

4. 验证API符号兼容性 #

少数情况下，符号名称或位置在版本迭代中可能变更，可查看本地包代码确认符号存在：

ls $GOPATH/pkg/mod/github.com/confluentinc/confluent-kafka-go/v2/kafka/

内容的提问来源于stack exchange，提问作者Suriya Varman N