loan-backend/docs/esign-sdk-install.md

e签宝SDK安装指南

问题说明

如果Maven仓库无法访问，会出现以下错误：

Failed to read artifact descriptor for com.esign:esign-sdk-java:jar:3.6.0
Could not transfer artifact ... 不知道这样的主机。 (mvn.esign.cn)

解决方案

方案1：手动安装到本地Maven仓库（推荐）

1. 下载SDK

   • 访问 e签宝开放平台：https://open.esign.cn/
   • 登录后进入"开发文档" -> "SDK下载"
   • 下载 esign-sdk-java-3.6.0.jar

2. 安装到本地仓库

   mvn install:install-file ^
    -Dfile=esign-sdk-java-3.6.0.jar ^
    -DgroupId=com.esign ^
    -DartifactId=esign-sdk-java ^
    -Dversion=3.6.0 ^
    -Dpackaging=jar
   

方案2：使用system scope（临时方案）

1. 下载SDK到项目lib目录

   • 在项目根目录创建 lib 文件夹
   • 将 esign-sdk-java-3.6.0.jar 放入 lib 目录

2. 修改pom.xml

   • 注释掉原有的依赖
   • 取消注释 system scope 的依赖配置（在pom.xml中已提供）

方案3：配置代理（如果可以访问外网）

如果您的网络需要代理，在 ~/.m2/settings.xml 中配置：

<settings>
  <proxies>
    <proxy>
      <id>myproxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>your-proxy-host</host>
      <port>your-proxy-port</port>
    </proxy>
  </proxies>
</settings>

验证安装

运行以下命令验证依赖是否已正确解析：

mvn dependency:tree -Dincludes=com.esign:esign-sdk-java

如果看到依赖树中包含 esign-sdk-java:jar:3.6.0，说明安装成功。

注意事项

1. 版本号：确保下载的SDK版本与pom.xml中的版本一致（当前为3.6.0）
2. 网络问题：如果公司内网无法访问e签宝仓库，优先使用方案1
3. Maven仓库：方案1会将jar安装到本地Maven仓库（通常在 ~/.m2/repository）