SpringBoot多环境+docker集成企业微信会话存档sdk
文章来自于 https://developer.work.weixin.qq.com/community/article/detail?content_id=16529801754907176021
SpringBoot多环境+docker集成企业微信会话存档sdk
对于现在基本流行的springboot环境，官方文档真是比较坑的，基本都要自己摸索。
以下代码大家根据自己项目调整，无需生搬硬套，代码不重要，主要了解到其中的思路和坑点。
一. 主要目录结构
hell
├─src
│ ├─main
│ │ ├─java
│ │ │ └─com
│ │ │ ├─ft
│ │ │ │ └─qb
│ │ │ │ └─job
│ │ │ │ └─biz
│ │ │ │ └─employee
│ │ │ │ └─qywx
│ │ │ │ └─QywxMessageWinJob.java # 业务主入口，定时任务执行入口
│ │ │ └─tencent
│ │ │ └─wework
│ │ │ └─Finance.java # 企业微信sdk中的Finance.java文件copy过来（切记，包名不能错）
│ │ └─resources
│ │ ├─config
│ │ └─lib
│ │ └─qywx
│ │ └─linux
│ │ └─libWeWorkFinanceSdk_Java.so # 企业微信linux sdk中的同名文件
│ │ └─libWeWorkFinanceSdk.so # copy自libWeWorkFinanceSdk_Java.so，改名
│ │ └─win
│ │ └─libcrypto-1_1-x64.dll # 企业微信linux sdk中的同名文件
│ │ └─libcurl-x64.dll # 企业微信linux sdk中的同名文件
│ │ └─libssl-1_1-x64.dll # 企业微信linux sdk中的同名文件
│ │ └─WeWorkFinanceSdk.dll # 企业微信linux sdk中的同名文件
注意：
- Finance.java文件的包名千万不能错，一定要是com.tencent.wework。
- linux下的sdk中libWeWorkFinanceSdk_Java.so要改名为libWeWorkFinanceSdk.so，后面都是使用这个libWeWorkFinanceSdk.so。别TM问为什么，我也想知道为什么，腾讯的程序员不出来解释一下么？文档中没有提及，完全的大坑，我也是看了某个老兄的帖子才改的。
实际项目截图：
二. 改造Finance.java文件
因为sdk是分win和linux环境的，所以我们需要对Finance.java进行一些改造，使之可以判断win和linux环境，自动切换加载的dll或so文件。
修改static部分的代码：
avastatic {if (isWindows()) {// win。获取4个dll的实际位置，下边使用System.load来加载dll。String path = System.getProperty("user.dir") + "\\src\\main\\resources\\lib\\qywx\\win\\";path = path.replaceAll("%20", " ").replaceFirst("/", "").replace("/", "\\\\");//加载顺序不能变System.load(path.concat("libcrypto-1_1-x64.dll"));System.load(path.concat("libssl-1_1-x64.dll"));System.load(path.concat("libcurl-x64.dll"));System.load(path.concat("WeWorkFinanceSdk.dll"));} else {// linux。加载指定so文件在linux系统下的位置。// docker的话这行也可以不要。这里有点小坑，后文会讲。System.load("/usr/lib/libWeWorkFinanceSdk.so");}//这行是本身Finance.java就有的，别丢掉。System.loadLibrary("WeWorkFinanceSdk");}public static boolean isWindows() {String osName = System.getProperties().getProperty("os.name");return osName.toUpperCase().indexOf("WINDOWS") != -1;}
自建一个isWindows()方法来判断当前的运行环境。然后在static中根据环境加载不同的dll和so就可以了。
三、win & linux
在win或linux运行，看一下主程序调用入口文件QywxMessageWinJob.java。
package com.ft.qb.job.biz.employee.job;import com.tencent.wework.Finance;import com.xxl.job.core.handler.annotation.XxlJob;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;import java.io.File;
import java.lang.reflect.Field;/*** 用于调用企业微信接口，获取会话存到内容，持久化到数据库*/
@Component
@Slf4j
public class QywxMessageWinJob {@Value("${project.qywx.session-message.corpid}")private String corpid;@Value("${project.qywx.session-message.secret}")private String secret;@XxlJob("QywxMessageJob_syncMessage")public void syncMessage() {try {long ret = 0;//使用sdk前需要初始化，初始化成功后的sdk可以一直使用。//如需并发调用sdk，建议每个线程持有一个sdk实例。//初始化时请填入自己企业的corpid与secrectkey。long sdk = Finance.NewSdk();ret = Finance.Init(sdk, this.corpid, this.secret);}catch(Exception e){log.error("企业微信会话sdk初始化失败：", e);throw e;}log.info("sdk加载成功了，继续!!!");}}
只要上一步Finance.java别改错，基本上就run通了。
四、docker
docker环境比较特殊。
- 一定要注意不要使用alpine版本的java镜像做基础镜像，会丢失一些基础的so文件，导致sdk加载失败。
基础镜像FROM openjdk:17-jdk-alpine
比如我一开始是openjdk:17-jdk-alpine镜像，当Finance.java执行到System.loadLibrary(“WeWorkFinanceSdk”)的时候，会报错找不到ld-linux-x86-64.so.2
java.lang.UnsatisfiedLinkError: /usr/lib/libWeWorkFinanceSdk.so: Error loading shared library ld-linux-x86-64.so.2: No such file or directory (needed by /usr/lib/libWeWorkFinanceSdk.so)
- 将libWeWorkFinanceSdk.so放入docker镜像中。在DockerFile中加一行copy libWeWorkFinanceSdk_Java.so
# 基础镜像FROM openjdk:17-jdk# copy libWeWorkFinanceSdk_Java.soCOPY src/main/resources/lib/qywx/linux/libWeWorkFinanceSdk.so /usr/lib/libWeWorkFinanceSdk.soADD target/app.jar app.jar# 更改为中国时区RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtimeRUN echo 'Asia/Shanghai' >/etc/timezone# 启动容器时执行ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-Ddruid.mysql.usePingMethod=false","-jar","app.jar"]# 使用端口80EXPOSE 29202 29203
这里如果加了这行copy，因为jdk容器中，/usr/lib属于java的运行时目录，所以Finance.java文件中的 System.load(“/usr/lib/libWeWorkFinanceSdk.so”); 这行加不加是无所谓的。
下边执行的System.loadLibrary(“WeWorkFinanceSdk”);会自动在/usr/lib目录中加载到WeWorkFinanceSdk的。
如上，根据自己的项目改改，基本都是可以run通的。
使用端口80
EXPOSE 29202 29203
这里如果加了这行copy，因为jdk容器中，/usr/lib属于java的运行时目录，所以**Finance.java**文件中的**System.load("/usr/lib/libWeWorkFinanceSdk.so");**这行加不加是无所谓的。下边执行的**System.loadLibrary("WeWorkFinanceSdk");**会自动在/usr/lib目录中加载到**WeWorkFinanceSdk**的。如上，根据自己的项目改改，基本都是可以run通的。
