首页
/ DaWarIch项目中Trip详情页图片加载问题分析与修复

DaWarIch项目中Trip详情页图片加载问题分析与修复

2025-06-13 10:06:22作者:虞亚竹Luna

问题背景

在DaWarIch项目的0.19.3版本中,用户发现Trip详情页面中的图片无法正常显示。这是一个典型的图片资源加载失败问题,涉及到前端与后端API的交互方式。

问题现象

当用户完成以下操作流程时会出现问题:

  1. 上传图片到Immich存储服务
  2. 连接Immich和DaWarIch系统
  3. 访问Trips页面
  4. 点击查看某个Trip的详情
  5. 发现图片无法显示

技术分析

通过开发者工具检查发现,图片请求的URL格式为:

/api/v1/photos/ef9f2771-b67a-45d5-8ce1-f9e22973ab2d/thumbnail.jpg?api_key=b74121779a1d1ecb12546e522a4f70f1

而实际上,系统需要添加source=immich参数才能正确获取图片资源。修改后的有效URL应为:

/api/v1/photos/ef9f2771-b67a-45d5-8ce1-f9e22973ab2d/thumbnail.jpg?api_key=b74121779a1d1ecb12546e522a4f70f1&source=immich

根本原因

问题出在前端控制器代码中生成图片URL的逻辑不完整。在maps_controller.js文件中,构建图片URL时没有包含必要的source参数,导致后端无法识别图片来源。

解决方案

开发团队通过修改前端控制器代码解决了这个问题。具体修改是将:

const thumbnailUrl = `/api/v1/photos/${photo.id}/thumbnail.jpg?api_key=${this.apiKey}`;

更新为:

const thumbnailUrl = `/api/v1/photos/${photo.id}/thumbnail.jpg?api_key=${this.apiKey}&source=immich`;

技术启示

  1. API参数完整性:在调用第三方服务API时,必须确保所有必需参数都正确传递
  2. 前后端协作:这类问题往往需要前后端开发人员共同排查,理解完整的请求链路
  3. 测试覆盖:对于多数据源的应用,应该增加针对不同来源数据的测试用例

修复版本

该问题已在0.19.4版本中得到修复,用户升级后即可正常显示Trip详情中的图片。

登录后查看全文
热门项目推荐
相关项目推荐