my-springboot-project/docs/图片URL优化更新文档.md

图片 URL 优化更新文档

概述

本次更新优化了图片访问方式，从原来通过后端 API 代理访问改为直接通过 Nginx 静态资源访问，提高了图片加载效率。

修改内容

1. 配置文件

• 使用配置项 file.upload.path 确定本地保存路径
• 使用配置项 file.upload.url-prefix 确定 Nginx 访问前缀（默认为 /files/）

2. ImageService 接口

• 新增 getNginxUrlByImageId(String imageId) 方法，用于根据图片 ID 获取 Nginx 格式的 URL

3. ImageServiceImpl 实现

• 使用配置的 file.upload.path + /img 作为图片存储目录
• 保存图片时返回相对路径（如 img/xxx.jpg）而非绝对路径
• 修改本地读取图片逻辑，支持相对路径
• 新增 getNginxUrlByImageId 方法
• 新增 extractFilenameFromPath 辅助方法

4. AiChatServiceImpl 修改

• 在保存图片后立即更新 imageMetadata 中的 url 为 Nginx 格式
• 在 SSE 的 finish 事件中，对无 metadata 的图片也尝试生成 Nginx 格式 URL

5. ChatServiceImpl 修改

• 查看历史记录时，将图片 URL 从 /api/image/xxx/data 转换为 Nginx 格式（/files/img/xxx.jpg）

使用示例

Nginx 配置示例

server {
    listen 80;
    
    location /files/ {
        alias /path/to/upload/;
        expires 7d;
        add_header Cache-Control "public, immutable";
    }
    
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

配置文件 (application-prod.yml)

file:
  upload:
    path: /opt/deploy/uploads/
    url-prefix: /files/

部署说明

1. 确保 Nginx 配置正确，/files/ 路径指向实际的上传目录
2. 确保应用配置文件中的 file.upload.path 和 file.upload.url-prefix 设置正确
3. 重新构建并部署应用

兼容性

• 保留了向后兼容，如果 Nginx 格式 URL 无法获取，会回退为原 /api/image/xxx/data 格式
• 旧数据仍然可以正常访问

图片 URL 格式对比

旧格式	新格式
/api/image/xxx/data	/files/img/xxx.jpg