问题场景的观点是，Prompt硬编码的“坏味道”

先回顾上一篇的代码：

public String chat { return chatClient.prompt .user // 使用者的输入倒是动态的 .call .content;}

看起来还好对吧？但真实业务场景是这样的：

// 场景1：客服程序，需要给AI设定人设.user// 场景2：代码审查，需要统一输出格式.user// 场景3：多语言翻译。需要指定源语言和目标语言.user

三个问题立刻暴露：

1. 提示词和代码耦合改一个字就要重新编译部署
2. 无法复用同一个角色设定，多个接口要复制粘贴
3. 难以管理提示词散落在各个Service里产品和运营想调优？先把IDE装上

后端老鸟的直觉反应：这玩意儿应该放到配置文件里。

Spring AI的答案：PromptTemplate

Spring AI提供了一个 PromptTemplate用法和 RestTemplateJdbcTemplate 一样，看名字就知道是干嘛的。

它的主要思想就一句话：用占位符代替硬编码，运行时动态填充。

先看一个最简单的例子：

// 以前：硬编码.user// 现在：占位符模板.user

代码实现细节

package com.yunxi.ai.service;import org.springframework.ai.chat.client.ChatClient;import org.springframework.ai.chat.prompt.PromptTemplate;import org.springframework.stereotype.Service;@Service
public class ChatService {
private final ChatClient chatClient;public ChatService {
this.chatClient = builder.build;}
public String chatWithTemplate {
// 定义模板。占位符用 {变量名}
PromptTemplate template = new PromptTemplate(
"你是一个专业的{role}，请用{tone}的语气回答使用者的问题。说到使用者问题，{message}"
);// 填充占位符
template.add;template.add;template.add;// 渲染成最终Prompt，发给AI
return chatClient.prompt
.user)
.call
.content;}
}

package com.yunxi.ai.controller;import com.yunxi.ai.service.ChatService;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;@RestController
public class ChatController {
private final ChatService chatService;public ChatController {
this.chatService = chatService;}
@GetMapping
public String chatWithTemplate(
@RequestParam String role。@RequestParam String tone,@RequestParam String message) {
return chatService.chatWithTemplate;怎么说呢，}
}

测试链接示例：

• 至于http。//localhost:/chat/template?role=毒舌代码审查员&tone=刻薄但专业&message=这段代码有性能问题吗
• AI返回示例…

真正的工程化这方面。放到配置文件里

上面虽然用了模板，但模板字符串仍然嵌在Java里。真正优雅的是把模板提取到外部配置，让业务逻辑与提示词完全解耦。

ST 文件示例

方法	内容
src/main/resources/prompts/customer-service.st src/main/resources/prompts/code-review.st	'你是一个资深Java代码审查员。怎么说呢，审查要点： . 至于命名规范，类名大驼峰，方法名小驼峰，变量名有意义. 性能问题的观点是，循环内查库、N+1问题、大对象创建. 安全漏洞的观点是。SQL注入、XSS、敏感信息泄露请对以下代码进行审查，按"严重程度|问题描述|修改建议"格式输出:{code} ' '你是一个专业客服人员，你叫小慧。按理说，工作要求： . 语气温和有礼，多用"您"、"请"等敬语. 如果使用者投诉优先安抚情绪再解决. 如果遇到不懂的问题诚实告知并建议联系人工客服. 回答简洁。不超过200字 使用者问题:{message}请回答： '

StPromptService

package com.yunxi.ai.service;import org.springframework.ai.chat.client.ChatClient;import org.springframework.ai.chat.prompt.PromptTemplate;import org.springframework.beans.factory.annotation.Value;import org.springframework.core.io.Resource;import org.springframework.stereotype.Service;其实，import java.io.IOException;怎么说呢，import java.nio.charset.StandardCharsets;@Service
public class StPromptService {
private final ChatClient chatClient;@Value
private Resource customerServicePrompt;@Value
private Resource codeReviewPrompt;public StPromptService {
this.chatClient = builder.build;}
public String chat throws IOException {
Resource resource = switch {
case "customer-service" -> customerServicePrompt;
case "code-review" -> codeReviewPrompt;default -> throw new IllegalArgumentException;}，String templateContent = new String.readAllBytes,StandardCharsets.UTF_8);按理说，PromptTemplate template = new PromptTemplate;if ) template.add;if ) template.add;return chatClient.prompt
.user)
.call
.content;}
}

PromptConfigController

package com.yunxi.ai.controller;

import com.yunxi.ai.service.StPromptService;import org.springframework.web.bind.annotation.GetMapping;不过，import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;

@RestController public class PromptConfigController{ private final StPrompt Service stpromptservice;public PromptConfigControlle r{ this.stpromptservice=stpromptservice;} @GetMapping public String chata wwithconfigthrows IOException{ return stpromptservice.c hat;按理说，} }

: src/main/resources/ ├── application.yml └── prompts/ ├── customer-service.st └── code-review.st

@Value 注入资源文件、外部化配置、模板占位符——全是 Spring 环境标准玩法。

程序提示词 vs 使用者提示词

The first article only used .user。but re's a more important component: SYSTEM MESSAGE..

消息类型	角色	用途
SystemMessage	AI 的行为规则/角色/输出格式设置	设置全局指令或约束规则，例如「返回JSON」或「保持中立口吻」等。
UserMessage	使用者输入/具体任务/请求指令；老实说，属于当前轮次交互主体。	提交具体需求，如「帮我翻译这句话」或「生成接口文档」等。
AssistantMessage	AI 的历史回复；多轮对话使用，用于上下文记忆。

**关键**: 将“人设”或“规则”放在 SystemMessage 中。而不是 UserMessage，以免被任务内容覆盖。

java public String chatWithSystem( String systemPrompt,String userMessage ) { return chatClien t.prompt .system /* 程序设定 */ .user /* 当前任务 */ \t.call \t.content;}

本篇避坑教程

• : 模板渲染失败导致占位符未被替换；或者忘记添加值至 PromptTemplate 对象。: 在渲染前打印 `template.render` 并做断言；封装工具方法确保所有必需变量均已填充。其实，: 使用 `Optional` 或自定义 `addOrThrow` 方法来避免遗漏。举例： `template.addOrThrow`;` 验证步骤： `String preview = template.render;assert，preview.contains;不过，`

• : 默认读取编码为 ISO‑8859‑1 或其他非UTF‑8 编码导致中文字符被破坏。: 明确指定 `.getContentAsString` 或使用 `InputStreamReader` 指定 UTF‑8。

• : 模型有限，例如 Qwen-plus 最大128K token；超长会被截断，从而丢失关键信息或导致错误结果。: 控制 prompt 长度；必要时拆分为多条消息，或长度并配合分页处理。

• : 将任务细节塞进 SystemMessage 会让 AI 忘记预设规则；其实，反之，把规则塞进 UserMessage 会让其成为普通指令而非全局约束。: 明确区分两者—— System 用来定义全局行为与格式要求；User 用来提交具体请求。

本篇小结 & 接下来计划

• ★ ✅ Prompt Template 替代硬编码字符串，实现动态占位符填充与复用能力。  

★ ✅ ST 文件式模板管理，让大量不同场景下可维护且可版本控制。.  

★ ✅ 正确划分 System / User / Assistant 消息，让模型始终遵循预期规则并高效完成任务。  

★ 面向未来——如何让 AI 输出结构化数据直接映射为 Java 对象。说起来，下一篇将详细讨论 “结构化输出” 与 “DTO 自动映射”。

• 这篇文章与 DeepSeek 协作完成 •

---