后端项目初始化

环境准备

安装的 JDK 版本必须是 21 以上，最好是 21 ，因为支持使用虚拟线程

**不能使用其他版本

新建项目

在 IDEA 中新建项目，选择 Spring Boot 模板，注意需要确保 Server URL 为 https://start.spring.io/

![[Pasted image 20251106194511.png]]

Spring Boot 版本选择 3.4.11，然后再顺手选上 SpringWeb 和 Lombok

![[Pasted image 20251106194721.png]]

整合依赖

整合 Huto‎ol 工具库和 Kn‌ife4j

Hutool 工具库

参考官方文档引入：https://doc.hutool.cn/pages/index/#%F0%9F%8D%8Amaven

在 Maven 的 pom.xml 中添加依赖：

<dependency>  
    <groupId>cn.hutool</groupId>  
    <artifactId>hutool-all</artifactId>  
    <version>5.8.37</version>  
</dependency>

Knife4j 接口文档

参考官方文档引入，注意这里使用的是 Spring Boot 3.x，不要引入错版本了：

在 Maven 的 pom.xml 中添加依赖：

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

创建 controller 包存放 API 接口，编写一个健康检查接口用于测试是否能够正常引入：

@RestController  
@RequestMapping("/health")  
public class HealthController {  
  
    @GetMapping  
    public String HealthCheck() {  
        return "ok";  
    }  
}

根据官网文档在 application.yml 中追加接口文档配置，并且扫描 controller 包
- 注意：包扫描那里是 ==.== 不是 ==/==

spring:  
  application:  
    name: super-ai-agent  
server:  
  port: 8123  
  servlet:  
    context-path: /api  
# springdoc-openapi项目配置  
springdoc:  
  swagger-ui:  
    path: /swagger-ui.html  
    tags-sorter: alpha  
    operations-sorter: alpha  
  api-docs:  
    path: /v3/api-docs  
  group-configs:  
    - group: 'default'  
      paths-to-match: '/**'  
      packages-to-scan: com.example.superaiagent.controller  
# knife4j的增强配置，不需要增强可以不配  
knife4j:  
  enable: true  
  setting:  
    language: zh_cn

启动项目，访问 http://localhost:8123/api/doc.html 能够看到接口文档，可以测试调用接口：

![[Pasted image 20251106203306.png]]

超级智能体