Immich项目v1.131.1版本中的本地化存储问题分析

Immich是一款开源的图片管理应用，在最新发布的v1.131.1版本中，部分用户遇到了界面无法正常加载的问题。本文将深入分析这一问题的成因和解决方案。

问题现象

当用户升级到v1.131.1版本后，访问Web界面时会出现以下情况：

1. 页面持续显示加载动画，无法进入主界面
2. 浏览器控制台报错"RangeError: Incorrect locale information provided"
3. 检查浏览器本地存储发现locale键值为空

技术分析

该问题的根源在于应用的本地化(locale)信息处理机制。Immich使用浏览器的本地存储来保存用户的语言偏好设置，但在某些情况下，这个值可能为空或无效。

具体来说，问题出现在字节单位转换的代码逻辑中。当应用尝试使用空白的locale值进行数字格式化时，会触发JavaScript的RangeError异常，导致整个界面渲染过程中断。

解决方案

对于遇到此问题的用户，有以下几种解决方法：

1. 清除浏览器存储：

   • 清除该网站的所有本地存储数据（包括cookies和session）
   • 刷新页面后，系统会重新生成正确的locale值

2. 手动设置locale值：

   • 打开浏览器开发者工具
   • 进入"应用"→"本地存储"部分
   • 找到"locale"键，手动设置为有效的语言代码（如"en-US"、"zh-CN"等）
   • 刷新页面

3. 使用隐私浏览模式：

   • 隐私/无痕模式会使用全新的存储空间
   • 这种方式可以绕过现有存储中的错误配置

预防措施

从开发角度，这个问题提示我们需要：

1. 对本地存储的值进行有效性验证
2. 为locale设置合理的默认值
3. 在格式化函数中添加错误处理逻辑

Immich开发团队已经注意到这个问题，预计会在后续版本中修复。对于普通用户来说，按照上述解决方案操作即可恢复正常使用。