# session-save

**Repository Path**: li_jianglong/session-save

## Basic Information

- **Project Name**: session-save
- **Description**: 企微demo会话存档
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 会话存档DEMO如何使用

#### 注意！

<mark>**本demo依赖于企微会话存档sdk，目前sdk只有windows版本和Linuxs版本，因此如果需要使用本demo只能使用window平台和Linux平台，暂不支持Macos或者其他平台**</mark>



### 1、环境
* windows系统或者Linux系统
* java 11
* mysql 8
* maven3.6
* 腾讯云cos
* rabbitmq
### 2、主要依赖包
* hutools
* fastjson
* lombok
* mybatis-plus
* 以及解密关依赖
* ....
### 3、windows下如何使用
* 首先将企微会话存档Windows的sdk文件夹下面的ddl文件全部放入如下路径 C:\Windows\System32  
* 在执行根目录下sql/init.sql
* 修改yml中的配置
  * 对象存储的配置
    ```
    config:
        cos:
           secretKey: xxxxx
           secretId: xxxxx
           bucketName: xxxxx
           regionName: xxxxx
           filePath: 这里是你的对象存储访问地址+储存桶地址
        wxcp:
            corpId：xxxxxx
            secret：xxxxxx
    ```
        
* 修改数据库中xx表中的秘钥对
* 启动项目
* 走sdk拉取消息的实现逻辑在这里 com.thought.wxsession.task.WxMessageTask
### 4、Linuxs下如何使用
* 执行sql/init.sql
* 参考3.3修改配置
* 启动项目

### 5、FAQ

* Q: 我没有对接腾讯云储存怎么办，或者我对接的是其他的云储存怎么办？
* A: 
  - a.注释掉如下路径下的类  
    ```
     com.thought.wxsession.runner.CosClientRunner
     com.thought.wxsession.config.CosPropertiesConstantsUtils
     com.thought.wxsession.utils.CosUtils
    ```
  - b.注释掉如下路径的代码
    ```
     com.thought.wxsession.utils.SessionUtils.java:57
    ```
  - c.去掉腾讯云cos依赖
              
  - d.去掉yml中腾讯云的配置
----
* Q: 我没有用rabbitmq怎么办，或者我用的是其他的mq怎么办？
* A：
    - mq可以自己改成racket或者kfk，直接把消费者的逻辑拿过去就行了，如果没有用mq或者不想用mq可以自己另外起线程异步去做是一样的。或者我也不想用mq也不想异步 那你直接改成同步逻辑。 
          如果不会改那么请关掉这个页面。
----
* Q: 消息解密失败返回10008怎么办？
* A:
  - 可能是秘钥对生成的不对，建议看企微官方[文档](https://developer.work.weixin.qq.com/document/path/91552)生成秘钥对  
  - 建议使用openssl 来生成rsa pkcs1 2048格式的公私钥。例如可使用：openssl genrsa -out private.pem 2048 来生成私钥，并使用
           openssl rsa -in private.pem -pubout -out public.pem从私钥来产生公钥。 
  - 如果还是按照文档生成秘钥还是报错，建议去企微社区提问让企微官方的同学来看。
----  
* Q：我用Macos为什么启动项目报错
* A:
  - 关掉这个页面就可以解决！
----
* Q: 我把包名修改了之后sdk报错怎么办？
* A:
  - 包名可以改，但是 Finance类 一定要在 com.tencent.wework.Finance 这个路径下，不然会出现很多奇怪的问题。
----


### 感谢
- mq工具类参考 @ladyboss-西瓜
- 责任链写法和实现参考 @cyys-xvlang
     
-   参考博客: [企业微信-会话内容存档(从零开始，完整demo)](https://blog.csdn.net/IT_Yl/article/details/123224180#comments_24652008)
### 友情链接
- [提问的智慧](./HELP.md)