Immich-go工具中on-server-errors参数的使用注意事项

Immich-go是一个用于管理Immich照片管理系统的命令行工具，其中upload from-immich命令允许用户从一个Immich服务器迁移数据到另一个服务器。在实际使用过程中，部分用户可能会遇到on-server-errors参数无法识别的问题。

问题现象

当用户尝试使用以下命令时：

./immich-go upload from-immich --on-server-errors=continue --from-server=http://192.168.18.100:2283 --from-api-key=xxx --server=http://192.168.18.155:8181 --api-key=xxx

系统会返回错误提示"unknown flag: --on-server-errors"，表明该参数在当前版本中不可用。

原因分析

经过排查发现，这个问题通常是由于使用了较旧版本的immich-go工具导致的。在早期版本中，确实没有实现on-server-errors这个参数功能。

解决方案

要解决这个问题，用户需要将immich-go工具升级到最新版本（当前最新为v0.24.6）。新版本已经完整实现了on-server-errors参数功能，该参数允许在服务器端出现错误时继续执行后续操作，而不是立即终止整个迁移过程。

参数功能说明

on-server-errors参数是一个非常有用的故障处理选项，它支持以下两种模式：

1. abort（默认值）：当遇到服务器错误时立即停止操作
2. continue：遇到服务器错误时跳过当前项目继续执行后续操作

对于大规模数据迁移场景，建议使用continue模式，这样可以确保即使个别文件出现问题，也不会影响整体迁移进度。

最佳实践建议

1. 在执行重要数据迁移前，务必确认使用的是最新版本工具
2. 可以先使用--dry-run参数进行模拟运行，检查可能存在的问题
3. 对于大型迁移任务，建议配合使用日志记录功能（--log-file参数）
4. 考虑使用--from-date-range参数分批迁移数据，降低风险

通过保持工具版本更新和合理使用这些参数，可以显著提高Immich数据迁移的成功率和效率。