启动基于Ballerina服务的K8S Pod时遭遇UnsatisfiedLinkError错误

错误说明 #

启动基于Ballerina服务的K8S Pod时出现以下错误：

error: java.lang.UnsatisfiedLinkError {"message":"failed to load the required native library","cause":error("java.lang.IllegalArgumentException",message="Failed to load any of the given libraries: [netty_tcnative_linux_x86_64, netty_tcnative_linux_x86_64_fedora, netty_tcnative_x86_64, netty_tcnative]")}
使用的运行时环境为ballerina/jvm-runtime:1.0。

错误原因 #

该错误源于ballerina/jvm-runtime:1.0镜像未预装Netty TLS/SSL功能依赖的netty_tcnative原生库，导致JVM无法加载必要组件。

解决方案 #

• 方案1：替换为完整Ballerina发行版镜像
  使用包含所有依赖的Ballerina官方发行版镜像（而非仅JVM runtime镜像），比如ballerina/ballerina:1.0.x（x为具体小版本号），这类镜像预装了所有原生依赖。修改K8S Pod的容器配置：

  containers:
  - name: your-ballerina-service
    image: ballerina/ballerina:1.0.8  # 替换为对应版本
    # 其他配置项
  

• 方案2：自定义镜像补充依赖库
  若必须使用ballerina/jvm-runtime:1.0，可基于它构建自定义镜像，安装缺失的系统库：

  1. 创建Dockerfile：

     FROM ballerina/jvm-runtime:1.0
     
     RUN apt-get update && apt-get install -y libnetty-tcnative-jni
     

  2. 构建自定义镜像：

     docker build -t custom-ballerina-runtime:1.0 .
     

  3. 在K8S配置中使用该自定义镜像。

• 方案3：禁用不必要的TLS功能
  如果服务不需要HTTPS/TLS功能，可修改Ballerina代码禁用相关配置，避免加载netty_tcnative库：

  // 使用普通HTTP监听器而非HTTPS
  listener http:Listener serviceListener = new(9090);
  

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