WenXin-Starter 常见问题解决方案

WenXin-Starter 常见问题解决方案

wenxin-starter 项目地址: https://gitcode.com/gh_mirrors/we/wenxin-starter

项目基础介绍

WenXin-Starter 是一个基于 Spring Boot 的高性能启动器，专为快速集成百度的“文心千帆 WENXINWORKSHOP”大模型而设计。该项目支持连续对话（流式返回）、Prompt 模板、文生图等功能，并内置了连续对话记录和消息记录导出功能。主要编程语言为 Java，依赖于 Spring Boot 框架。

新手使用注意事项及解决方案

1. JDK 版本要求

问题描述：项目基于 Spring Boot 3.0 开发，要求 JDK 版本为 17 及以上。如果本地 JDK 版本低于 17，项目将无法正常编译和运行。

解决方案：

1. 检查本地 JDK 版本：

   java -version
   

2. 如果版本低于 17，请下载并安装 JDK 17 或更高版本。
3. 配置环境变量，确保系统使用新安装的 JDK 版本。

2. 依赖管理

问题描述：新手在添加项目依赖时，可能会遇到 Maven 或 Gradle 配置错误，导致依赖无法正确下载。

解决方案：

1. 确保 Maven 或 Gradle 配置文件（pom.xml 或 build.gradle）中正确添加了 WenXin-Starter 依赖：
   • Maven:

     <dependency>
         <groupId>io.github.gemingjia</groupId>
         <artifactId>wenxin-starter</artifactId>
         <version>2.0.0-beta4</version>
     </dependency>
     

   • Gradle:

     implementation 'io.github.gemingjia:wenxin-starter:2.0.0-beta4'
     

2. 运行 Maven 或 Gradle 命令，确保依赖正确下载：

   mvn clean install
   

   或

   gradle build
   

3. Access Token 配置

问题描述：新手在配置 Access Token 时，可能会因为配置错误导致 API 调用失败。

解决方案：

1. 在 application.yml 或 application.properties 中正确配置 Access Token：
   • application.yml:

     gear:
       wenxin:
         access-token: xx.xxxxxxxxxx.xxxxxx.xxxxxxx.xxxxx-xxxx
     

   • application.properties:

     gear.wenxin.access-token=xx.xxxxxxxxxx.xxxxxx.xxxxxxx.xxxxx-xxxx
     

2. 确保 Access Token 是从百度文心千帆平台获取的，并且未过期。
3. 如果使用 API Key 和 Secret Key 生成 Access Token，确保配置正确：

   gear:
     wenxin:
       api-key: xxxxxxxxxxxxxxxxxxx
       secret-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   

通过以上步骤，新手可以顺利解决常见问题，快速上手 WenXin-Starter 项目。

wenxin-starter 项目地址: https://gitcode.com/gh_mirrors/we/wenxin-starter