Spring AI ChatMemory 参数保存问题解析与解决方案

问题背景

在使用 Spring AI 框架开发聊天应用时，开发者发现当使用 PromptUserSpec 构建聊天消息时，ChatMemory 功能存在一个关键问题：只有消息模板被保存到历史记录中，而实际的参数值没有被正确替换和保存。

问题现象

开发者通过 ChatClient 构建了一个包含动态参数的聊天请求，代码如下：

private ChatClient.ChatClientRequestSpec buildChatClientRequestSpecRAGAdvisor(Question question, String conversationId) {
    return chatClient.prompt()
            .user(userSpec -> userSpec
                    .text("{question} (error: '{error}')?")
                    .param("question", question.question())
                    .param("error", question.error()!=null?question.error():""))
            .advisors( advisorSpec -> advisorSpec.param(AbstractChatMemoryAdvisor.CHAT_MEMORY_CONVERSATION_ID_KEY, conversationId));
}

预期行为是保存完整的消息内容，例如："这是一个问题 (error: '发生错误')?"。但实际保存到 ChatMemory 中的却是未替换参数的模板字符串："{question} (error: {error})"。

技术分析

这个问题源于 Spring AI 框架中 ChatMemoryAdvisor 的实现机制。在原始实现中，PromptChatMemoryAdvisor 的 before 方法直接获取并存储了未渲染的消息模板：

this.getChatMemoryStore().add(this.doGetConversationId(request.adviseContext()), userMessage);

这种实现方式导致了参数替换在内存存储阶段被跳过，从而只保存了原始模板而非实际渲染后的消息内容。

解决方案

Spring AI 团队在 1.0.0-M8 版本中修复了这个问题。修复的核心思路是调整 ChatClient 的执行流程，确保在调用 Advisor 链之前先完成输入提示的渲染工作。这意味着：

1. 参数替换现在会在 Advisor 处理之前完成
2. ChatMemory 中存储的是已经渲染完成的实际消息内容
3. 所有类型的 Advisor 都能获得一致的已渲染消息

升级建议

对于遇到此问题的开发者，建议升级到 Spring AI 1.0.0-M8 或更高版本。升级后，ChatMemory 将能够正确保存包含实际参数值的完整消息内容。

最佳实践

在使用 Spring AI 的 ChatMemory 功能时，开发者应当：

1. 确保使用最新版本的 Spring AI 框架
2. 验证参数替换在历史记录中的正确性
3. 对于复杂的消息模板，考虑添加日志输出以调试参数替换过程
4. 在需要长期保存对话历史的场景中，定期检查 ChatMemory 存储的内容是否符合预期

总结

Spring AI 框架的 ChatMemory 功能为开发者提供了强大的对话状态管理能力。通过理解并应用最新的修复方案，开发者可以确保对话历史中保存的是完整的、经过参数替换的实际消息内容，从而为构建更智能、更可靠的聊天应用奠定基础。