GTE-Base-ZH赋能Java应用SpringBoot集成与语义搜索实战最近在做一个电商后台的搜索功能升级用户反馈说用关键词搜商品经常找不到想要的东西。比如用户搜“适合夏天穿的轻薄外套”传统的搜索可能只匹配到“外套”而“轻薄”、“夏天”这些语义就被忽略了。这让我开始琢磨能不能让搜索变得更“聪明”一点能理解用户真正的意图。后来接触到了文本向量模型特别是GTE-Base-ZH它是一个专门针对中文优化的模型能把一段文字转换成一串有意义的数字也就是向量。这样一来搜索就不再是简单的字符匹配而是变成了计算这些数字之间的相似度也就是语义上的接近程度。听起来很酷对吧但怎么把它用到我们熟悉的Java和SpringBoot项目里呢这篇文章我就来分享一下我们团队把GTE-Base-ZH集成到SpringBoot微服务中的实战过程。我们会从怎么调用模型服务开始聊到如何设计一个高效的向量化接口再到怎么处理高并发的相似度计算最后还会谈谈如何结合MySQL来存储和检索这些向量。整个过程我会尽量用大白话和实际代码来说明希望能给有类似想法的朋友一些参考。1. 为什么选择GTE-Base-ZH与SpringBoot在做技术选型时我们主要考虑了这几点。首先我们的业务场景以中文为主所以模型的中文理解能力是首要的。GTE-Base-ZH在这方面表现不错它在中文文本上进行了专门的训练对词语和句子的语义捕捉更准确。其次我们现有的技术栈是Java微服务框架用的是SpringBoot。这就要求集成方案必须对Java友好最好是能通过简单的HTTP API或者有成熟的Java SDK来调用。如果模型服务部署复杂或者调用方式太“重”就会增加整个团队的维护成本。最后是性能与效果的平衡。GTE-Base-ZH在效果和推理速度上达到了一个比较好的平衡点对于电商搜索、内容推荐这类需要实时响应的场景来说它既能提供不错的语义理解精度又不会让响应时间变得不可接受。简单来说GTE-Base-ZH SpringBoot的组合对于我们这种以Java技术栈为主、追求快速落地和稳定运行的中文应用团队是一个比较务实的选择。2. 搭建模型服务与SpringBoot项目骨架要把模型用起来第一步是得有个地方能跑它。我们选择了将GTE-Base-ZH模型部署为一个独立的推理服务这样我们的SpringBoot应用就可以像调用普通API一样去使用它。2.1 部署GTE-Base-ZH模型服务模型服务这块我们用了比较流行的FastAPI来包装因为它轻量、异步支持好写起来也快。下面是一个最简化的服务端代码示例它提供了一个/embedding接口# embedding_server.py from fastapi import FastAPI from pydantic import BaseModel from sentence_transformers import SentenceTransformer import numpy as np app FastAPI() # 加载GTE-Base-ZH模型 print(正在加载模型...) model SentenceTransformer(thenlper/gte-base-zh) print(模型加载完毕。) class TextRequest(BaseModel): texts: list[str] app.post(/embedding) async def get_embedding(request: TextRequest): 接收文本列表返回对应的向量列表 texts request.texts # 调用模型生成向量 embeddings model.encode(texts, normalize_embeddingsTrue) # 将numpy数组转换为列表方便JSON序列化 embeddings_list embeddings.tolist() return {embeddings: embeddings_list} if __name__ __main__: import uvicorn uvicorn.run(app, host0.0.0.0, port8000)你可以用python embedding_server.py命令启动这个服务。它会在本地的8000端口监听请求。这里的关键是model.encode方法它把传入的中文句子列表转换成了768维的向量这是GTE-Base-ZH模型的输出维度。normalize_embeddingsTrue参数很重要它会把向量归一化使得后续用余弦相似度计算时更加高效和准确。2.2 创建SpringBoot项目并集成调用模型服务跑起来后我们在SpringBoot这边就需要一个客户端去调用它。我们创建了一个标准的SpringBoot项目并引入了WebFlux来做非阻塞的HTTP调用以提升并发能力。首先在pom.xml里加入必要的依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-webflux/artifactId /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency然后我们定义一个数据模型来对应服务端的请求和响应// EmbeddingRequest.java import lombok.Data; import java.util.List; Data public class EmbeddingRequest { private ListString texts; } // EmbeddingResponse.java import lombok.Data; import java.util.List; Data public class EmbeddingResponse { private ListListFloat embeddings; }接下来是核心部分创建一个服务类来封装对模型服务的调用// EmbeddingService.java import org.springframework.stereotype.Service; import org.springframework.web.reactive.function.client.WebClient; import reactor.core.publisher.Mono; Service public class EmbeddingService { private final WebClient webClient; // 假设模型服务地址是 http://localhost:8000 public EmbeddingService(WebClient.Builder webClientBuilder) { this.webClient webClientBuilder.baseUrl(http://localhost:8000).build(); } public MonoEmbeddingResponse getEmbeddings(ListString texts) { EmbeddingRequest request new EmbeddingRequest(); request.setTexts(texts); return webClient.post() .uri(/embedding) .bodyValue(request) .retrieve() .bodyToMono(EmbeddingResponse.class); } }这样一个最基本的集成桥梁就搭好了。我们的Java应用现在可以通过EmbeddingService轻松地将中文文本发送给GTE-Base-ZH模型并拿到语义向量。3. 设计文本向量化与存储接口有了基础的调用能力我们需要设计一套更健壮、更实用的接口来处理实际的业务数据。这主要包括文本向量化的批处理、异步化以及向量结果的存储。3.1 构建高效稳定的向量化接口在实际业务中我们可能需要对大量商品标题、描述进行向量化。直接同步调用并且一次只处理一条效率太低了。我们对EmbeddingService进行了增强。首先考虑批量处理。模型服务本身支持一次输入多个文本我们应该充分利用这个特性。// 在EmbeddingService中增加批量处理方法 public MonoListListFloat batchGetEmbeddings(ListString textList) { // 这里可以加入分批逻辑比如每批50条防止请求过大 int batchSize 50; ListMonoListListFloat batchMonos new ArrayList(); for (int i 0; i textList.size(); i batchSize) { int end Math.min(i batchSize, textList.size()); ListString batch textList.subList(i, end); MonoListListFloat batchMono this.getEmbeddings(batch) .map(EmbeddingResponse::getEmbeddings) .onErrorResume(e - { // 记录错误并返回一个空列表或进行其他补偿操作 log.error(批量获取向量失败批次: {} - {}, i, end, e); return Mono.just(new ArrayList()); }); batchMonos.add(batchMono); } // 合并所有批次的结果 return Flux.concat(batchMonos).collectList().map(listOfLists - { ListListFloat allEmbeddings new ArrayList(); listOfLists.forEach(allEmbeddings::addAll); return allEmbeddings; }); }其次考虑异步与缓存。对于不经常变化的文本比如已上架的商品信息其向量也是不变的我们可以将向量结果缓存起来避免重复计算。Service public class VectorizationService { Autowired private EmbeddingService embeddingService; // 使用Spring Cache或Redis等缓存组件 Cacheable(value textEmbeddings, key #text) public MonoListFloat getOrCreateEmbedding(String text) { return embeddingService.getEmbeddings(Collections.singletonList(text)) .map(response - response.getEmbeddings().get(0)); } }3.2 设计MySQL向量存储方案向量生成后我们需要把它和原始数据比如商品ID、标题一起存起来。MySQL本身并不原生支持向量类型和向量索引但我们可以用BLOB或TEXT类型来存储序列化后的向量。我们设计了一张表CREATE TABLE product_embeddings ( id BIGINT PRIMARY KEY AUTO_INCREMENT, product_id VARCHAR(64) NOT NULL COMMENT 商品业务ID, product_title TEXT COMMENT 商品标题, embedding_vector TEXT NOT NULL COMMENT 标题向量JSON数组格式, created_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_product_id (product_id) ) COMMENT 商品语义向量表;在Java实体中我们需要处理向量ListFloat和数据库字段String之间的转换// ProductEmbedding.java Entity Table(name product_embeddings) Data public class ProductEmbedding { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; private String productId; private String productTitle; Column(columnDefinition TEXT) private String embeddingVectorJson; // 存储为JSON字符串 // 将ListFloat转换为JSON字符串存入 public void setEmbeddingVector(ListFloat vector) { ObjectMapper mapper new ObjectMapper(); try { this.embeddingVectorJson mapper.writeValueAsString(vector); } catch (JsonProcessingException e) { throw new RuntimeException(向量序列化失败, e); } } // 从JSON字符串解析出ListFloat public ListFloat getEmbeddingVector() { if (this.embeddingVectorJson null) return null; ObjectMapper mapper new ObjectMapper(); try { return mapper.readValue(this.embeddingVectorJson, new TypeReferenceListFloat(){}); } catch (JsonProcessingException e) { throw new RuntimeException(向量反序列化失败, e); } } }然后通过JpaRepository或MyBatis等持久层框架我们就可以方便地保存和读取向量数据了。当然把向量存在MySQL的TEXT字段里做相似度搜索时效率是瓶颈我们稍后会讨论优化方案。4. 实现高并发语义搜索功能这是最核心的部分即给定一个查询词如何从海量商品中找出语义最相似的那些。整个过程可以拆解为向量化查询词 - 计算相似度 - 返回Top K结果。4.1 实现相似度计算与检索首先我们需要一个工具方法来计算两个向量之间的余弦相似度。余弦相似度的值在-1到1之间越接近1表示越相似。// VectorSimilarityUtil.java public class VectorSimilarityUtil { /** * 计算两个向量的余弦相似度 * param vecA 向量A * param vecB 向量B * return 余弦相似度 */ public static float cosineSimilarity(ListFloat vecA, ListFloat vecB) { if (vecA.size() ! vecB.size()) { throw new IllegalArgumentException(向量维度必须相同); } float dotProduct 0.0f; float normA 0.0f; float normB 0.0f; for (int i 0; i vecA.size(); i) { float a vecA.get(i); float b vecB.get(i); dotProduct a * b; normA a * a; normB b * b; } if (normA 0 || normB 0) { return 0.0f; } return (float) (dotProduct / (Math.sqrt(normA) * Math.sqrt(normB))); } }有了相似度计算我们就可以实现一个最基础的“暴力搜索”了。也就是把查询向量和数据库里每一个商品的向量都算一遍相似度然后排序。这在数据量小的时候没问题。// SemanticSearchService.java - 基础暴力检索版 Service public class SemanticSearchService { Autowired private ProductEmbeddingRepository repository; Autowired private VectorizationService vectorizationService; public MonoListSearchResult naiveSearch(String query, int topK) { // 1. 将查询文本向量化 return vectorizationService.getOrCreateEmbedding(query) .flatMap(queryVector - { // 2. 获取所有商品向量 (警告数据量大时性能极差) ListProductEmbedding allProducts repository.findAll(); // 3. 计算每个商品与查询的相似度 ListSearchResult results allProducts.stream() .map(product - { float similarity VectorSimilarityUtil.cosineSimilarity( queryVector, product.getEmbeddingVector() ); return new SearchResult(product.getProductId(), product.getProductTitle(), similarity); }) .sorted((a, b) - Float.compare(b.getScore(), a.getScore())) // 降序 .limit(topK) .collect(Collectors.toList()); return Mono.just(results); }); } // 搜索结果封装类 Data AllArgsConstructor public static class SearchResult { private String productId; private String title; private float score; // 相似度得分 } }4.2 应对高并发与性能优化上面的“暴力搜索”显然无法用于生产环境。一旦商品数量上万计算就会变得极其缓慢。我们需要引入专门的向量数据库或向量索引来加速检索。一个折中且易于上手的方案是使用MySQL 向量近似搜索库。我们可以在应用层将MySQL中存储的向量加载到内存然后用像Spotify’s Annoy或Facebook’s Faiss这样的Java绑定库来构建索引。这里以一个小规模的示例展示如何用内存索引优化实际大规模请用专业向量数据库启动时加载数据到内存索引Component public class InMemoryVectorIndex { private MapString, ListFloat vectorMap new ConcurrentHashMap(); private AnnoyIndexString annoyIndex; // 假设使用某个Annoy的Java封装 private boolean isIndexBuilt false; PostConstruct public void init() { ListProductEmbedding all productEmbeddingRepository.findAll(); for (ProductEmbedding pe : all) { vectorMap.put(pe.getProductId(), pe.getEmbeddingVector()); } // 在这里构建Annoy索引... // annoyIndex.buildIndex(vectorMap); isIndexBuilt true; } public ListString search(ListFloat queryVector, int topK) { if (!isIndexBuilt) { // 降级为暴力搜索或返回空 return naiveSearchInMap(queryVector, topK); } // 使用Annoy索引进行近似最近邻搜索 // return annoyIndex.getNearest(queryVector, topK); return null; // 示例 } }改造搜索服务使用内存索引public MonoListSearchResult fastSearch(String query, int topK) { return vectorizationService.getOrCreateEmbedding(query) .map(queryVector - { // 使用内存索引快速查找最相似的productId ListString nearestProductIds inMemoryVectorIndex.search(queryVector, topK); // 根据ID获取商品详细信息 return nearestProductIds.stream() .map(pid - { ProductEmbedding pe repository.findByProductId(pid); // 可以再精确计算一次相似度用于排序 float exactScore VectorSimilarityUtil.cosineSimilarity( queryVector, pe.getEmbeddingVector() ); return new SearchResult(pid, pe.getProductTitle(), exactScore); }) .sorted((a,b)-Float.compare(b.getScore(), a.getScore())) .collect(Collectors.toList()); }); }对于真正的高并发、大数据量场景比如百万级以上向量建议将向量数据迁移到专业的向量数据库如Milvus、Qdrant或Weaviate。这些数据库内置了高效的近似最近邻ANN算法索引并且提供了Java客户端集成到SpringBoot中也非常方便能轻松应对高并发检索请求。5. 总结走完这一整套流程从模型服务部署、SpringBoot集成、接口设计到最后的搜索实现感觉像是给传统的搜索系统装上了一颗“理解语义”的大脑。最大的体会是技术选型和架构设计一定要贴合自己的实际场景。对于我们这种中等数据量、初期探索语义搜索的团队来说用SpringBoot调用HTTP模型服务搭配MySQL存储和内存索引是一个快速验证想法、看到效果的方式。它能让你在短时间内搭建起一个可运行的语义搜索原型去解决像商品搜索不准这样的具体问题。当然这个方案也有它的局限。当商品数量爆炸式增长或者对搜索速度要求极高时内存索引和MySQL可能会成为瓶颈。那时候就该考虑引入专业的向量数据库了把向量存储和检索这些重活交给更专业的工具去做我们的SpringBoot服务则专注于业务逻辑的编排。如果你也想在自己的Java应用里尝试语义搜索我的建议是先从一个小而具体的场景开始。比如先选一个核心的搜索功能接入看看效果和性能是否符合预期。别一开始就想着做大而全的系统。在实践过程中你会更清楚地知道自己的业务到底需要多高的精度、多快的速度以及愿意投入多少成本这些才是决定你技术架构走向的关键。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。