Windows下用Docker+Spring AI搭建DeepSeek聊天机器人实战指南

最近在帮几个Java开发者朋友搭建本地AI对话系统时，发现Windows环境下Docker的路径处理和权限配置简直是大型劝退现场。明明照着Linux教程操作，却总在volume挂载和端口映射环节翻车。本文将分享一套经过实战检验的Windows专属方案，重点解决三个核心痛点：Docker Desktop的WSL2兼容性问题、Spring AI与Ollama的模型加载异常，以及Redis持久化导致的对话中断。

1. 环境准备：避开Windows特有的三个坑

1.1 系统版本与WSL2配置

在Windows 11专业版上实测时，发现必须开启Hyper-V和虚拟机平台，否则Docker Desktop会频繁报错。通过PowerShell管理员模式执行：

# 启用Windows功能
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

# 设置WSL2为默认版本
wsl --set-default-version 2

注意：家庭版Windows需先升级到专业版，否则无法启用Hyper-V。曾有个学员用家庭版折腾6小时无果，最终重装系统解决。

1.2 JDK与Maven的特殊配置

由于Spring AI 1.0.0-M6对Java 23有实验性支持，推荐使用Azul Zulu JDK：

choco install zulu23-jdk -y
mvn -version | findstr "Java version"  # 应显示23.x

在settings.xml中添加阿里云镜像源时，Windows路径要用双反斜杠：

<mirror>
  <id>aliyunmaven</id>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>central</mirrorOf>
</mirror>

1.3 Docker Desktop的隐藏设置

打开Docker Desktop设置→Resources→WSL Integration，必须勾选"Enable integration with my default WSL distro"。曾遇到容器能启动但无法访问的情况，根源就是这个选项未启用。

2. 容器部署：Windows路径处理实战

2.1 Redis容器部署的路径陷阱

在Windows下创建挂载目录时，绝对不能用C:\docker\redis这种原生路径，必须转换为Linux风格：

# 错误示范（会导致权限拒绝）
docker run -v C:\docker\redis\data:/data

# 正确写法（使用/mnt前缀）
docker run -v /mnt/c/docker/redis/data:/data

推荐使用以下命令批量创建目录结构：

New-Item -Path "C:\docker\redis\conf" -ItemType Directory
New-Item -Path "C:\docker\redis\data" -ItemType Directory

2.2 Ollama容器的GPU支持方案

如果没有NVIDIA显卡，在docker run命令中要显式禁用GPU：

docker run -d \
  --device /dev/dri \
  -e OLLAMA_NO_CUDA=1 \
  -v /mnt/c/docker/ollama:/root/.ollama \
  ollama/ollama:0.6.2

模型下载时建议使用国内镜像加速：

docker exec ollama ollama pull deepseek-r1:7b --registry-mirror https://ollama-mirror.example.com

3. Spring AI集成中的Windows适配

3.1 配置文件的关键调整

在application.yml中，localhost在容器间通信时会解析失败，必须改用宿主机的实际IP：

spring:
  ai:
    ollama:
      base-url: http://host.docker.internal:11434  # 特殊域名指向宿主机

3.2 对话记忆持久化方案

原始方案的Redis存储存在中文乱码问题，需要修改RedisConfig：

@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
    RedisTemplate<String, Object> template = new RedisTemplate<>();
    template.setConnectionFactory(factory);
    
    // 关键修改：使用Jackson处理中文字符
    Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<>(Object.class);
    serializer.setObjectMapper(new ObjectMapper().registerModule(new JavaTimeModule()));
    
    template.setDefaultSerializer(serializer);
    return template;
}

3.3 连续对话的异常处理

Windows环境下网络波动更频繁，需要在Controller添加重试逻辑：

@Retryable(maxAttempts=3, backoff=@Backoff(delay=1000))
public String chat(@RequestParam String userId, @RequestParam String input) {
    // 原有逻辑
}

4. 调试与性能优化

4.1 常见错误排查表

错误现象	Windows特有原因	解决方案
AccessDeniedException	路径权限未继承	在Docker设置中共享驱动器
模型加载超时	WSL2内存不足	调整.wslconfig内存限制
Redis连接中断	防火墙阻止	添加入站规则允许6379端口

4.2 性能提升技巧

通过修改WSL2配置（%UserProfile%\.wslconfig）提升容器性能：

[wsl2]
memory=8GB
processors=4
localhostForwarding=true

对于DeepSeek模型响应慢的问题，可以启用流式响应：

@GetMapping(value="/stream", produces=MediaType.TEXT_EVENT_STREAM_VALUE)
public Flux<String> streamChat(@RequestParam String input) {
    return chatClient.stream().prompt()
        .user(input)
        .call()
        .map(ChatResponse::getOutput);
}

5. 进阶应用：构建可视化界面

虽然本文聚焦后端集成，但可以结合Vue.js快速搭建管理界面。在Spring Boot中添加：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
            .addResourceLocations("classpath:/static/");
    }
}

将打包后的Vue项目放入resources/static目录，即可通过http://localhost:8083访问。