Java环境Docker运行TDLight（TDLib分支）失败求助

你的核心问题出在Alpine镜像的musl libc与TDLight预编译本地库依赖的glibc不兼容，自行编译tdjni时又没匹配好TDLight的Java绑定版本和编译参数，导致类链接错误。以下是针对性解决步骤：

一、最简单的解决方案：换用glibc基础的JDK镜像 #

Alpine的musl libc和glibc API不完全兼容，TDLight官方预编译的tdjni库是基于glibc构建的，直接用Alpine会缺失依赖。换成Debian/Ubuntu基础的openjdk镜像可以彻底规避这个问题：

Dockerfile示例（openjdk:17-slim） #

FROM openjdk:17-slim
WORKDIR /app
# 复制你的Bot Jar包（假设Gradle构建输出在build/libs下）
COPY build/libs/your-telegram-bot.jar .
# 启动命令
CMD ["java", "-jar", "your-telegram-bot.jar"]

这个镜像体积比Alpine大，但兼容性拉满，无需额外安装依赖，直接运行即可。

二、坚持用Alpine？安装glibc兼容层和依赖 #

如果必须用Alpine镜像，需要安装glibc兼容库和TDLight需要的libc++：

Dockerfile示例（Alpine + glibc） #

# 使用集成了glibc的Alpine镜像，避免手动安装的麻烦
FROM frolvlad/alpine-glibc:alpine-3.18_glibc-2.38
# 安装OpenJDK 17和libc++
RUN apk add --no-cache openjdk17-jre-headless libc++
WORKDIR /app
COPY build/libs/your-telegram-bot.jar .
CMD ["java", "-jar", "your-telegram-bot.jar"]

如果不想用第三方glibc镜像，也可以手动安装：

FROM openjdk:17-alpine
# 安装glibc兼容层
RUN apk add --no-cache wget && \
    wget -q -O /etc/apk/keys/sgerrand.rsa.pub https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub && \
    wget https://github.com/sgerrand/alpine-pkg-glibc/releases/download/2.38-r0/glibc-2.38-r0.apk && \
    apk add glibc-2.38-r0.apk && \
    rm -f glibc-2.38-r0.apk /etc/apk/keys/sgerrand.rsa.pub wget
# 安装libc++
RUN apk add --no-cache libc++
WORKDIR /app
COPY build/libs/your-telegram-bot.jar .
CMD ["java", "-jar", "your-telegram-bot.jar"]

三、Gradle配置确保本地库正确打包 #

不管用哪个镜像，都要确保Gradle正确处理TDLight的本地库：

1. 依赖使用TDLight官方提供的包，不要自行编译（除非你清楚版本匹配规则）：

   // build.gradle
   dependencies {
       implementation 'it.tdlight:tdlight-java:4.0.0' // 替换为你使用的TDLight版本
       // 若需要指定架构的原生库，可添加：
       // implementation 'it.tdlight:tdlight-native:4.0.0:linux-x86_64'
   }
   

2. 用Shadow插件打包Jar时，确保本地库被包含并能被自动加载：

   plugins {
       id 'java'
       id 'com.github.johnrengelman.shadow' version '8.1.1'
   }
   
   shadowJar {
       // 自动包含TDLight的本地库
       mergeServiceFiles()
       manifest {
           attributes 'Main-Class': 'com.your.package.MainClass' // 替换为你的主类
       }
   }
   

   构建后用shadowJar任务生成的Jar包，会自动处理本地库的加载，无需手动指定java.library.path。

四、自行编译tdjni的注意事项（不推荐） #

如果你确实需要自行编译，必须满足以下条件：

• 编译时使用的TDLight源码版本完全匹配你项目中依赖的tdlight-java版本
• 编译参数必须指定正确的JNI目标版本（和你的JDK版本一致，比如JDK17对应JNI 17）
• 编译时要针对目标系统（Alpine的musl libc），添加-musl编译参数
• 编译生成的libtdjni.so要放在Java能找到的路径，且确保Java类的方法签名和JNI导出的函数完全匹配

但这个过程极易出错，优先推荐使用官方预编译依赖。

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