StreetComplete数据库升级失败问题分析与解决方案

问题背景

在StreetComplete应用从旧版本升级到v59.0-alpha4版本时，部分用户遇到了应用启动崩溃的问题。崩溃日志显示这是一个数据库迁移过程中出现的SQLite异常，具体表现为尝试添加已存在的列时失败。

技术分析

错误根源

崩溃日志中关键错误信息是：

android.database.sqlite.SQLiteException: duplicate column name: is_near

这表明应用在升级过程中尝试执行以下SQL语句时失败：

ALTER TABLE osm_element_edits ADD COLUMN is_near int DEFAULT 1 NOT NULL

深层原因

这个问题出现在数据库版本迁移过程中。is_near列是在v57.0版本中引入的（对应功能实现#5474）。正常情况下，数据库迁移脚本应该只会在从低于v57.0版本升级时执行添加该列的操作。

然而，某些特殊情况下（特别是从v52.0升级到v59.0-alpha4时），迁移脚本错误地尝试重复添加这个已经存在的列，导致应用崩溃。

解决方案

临时解决方案

对于遇到此问题的用户，可以尝试以下步骤：

1. 备份应用数据（如有重要任务未上传）
2. 卸载当前应用
3. 重新安装最新版本

长期修复

开发团队需要修改数据库迁移逻辑，确保：

1. 在执行ALTER TABLE前检查列是否已存在
2. 处理跨多个版本的升级路径时更加健壮
3. 改进错误处理机制，避免应用完全崩溃

技术建议

1. 数据库迁移最佳实践：

   • 使用PRAGMA table_info检查表结构
   • 实现条件性ALTER TABLE语句
   • 添加更详细的迁移日志

2. 崩溃恢复机制：

   • 在应用初始化早期建立崩溃报告机制
   • 对关键数据库操作添加try-catch块
   • 实现数据库修复或回滚策略

3. 版本兼容性测试：

   • 建立从各个历史版本到最新版的升级测试矩阵
   • 特别关注跨多个主要版本的升级路径

总结

数据库迁移是移动应用升级中的常见痛点。StreetComplete遇到的这个问题提醒我们，在编写数据库迁移脚本时需要特别考虑：

• 跨版本升级的兼容性
• 重复执行的幂等性
• 完善的错误处理和恢复机制

开发者应当将数据库迁移视为关键路径，投入更多测试资源，确保各种升级场景都能平稳过渡。