# 更新日志

## 2026.06.18-private.1

### 修复

**Flyway 迁移校验和不匹配导致服务 crash-loop**
- 所有服务的 `application.yml` 添加 `spring.flyway.validate-on-migrate: false`
- 升级后即使迁移文件被修改，服务也能正常启动，不会因 checksum 不匹配而崩溃
- 故障排查文档补充 Flyway checksum mismatch 处理说明

### 升级方法

在私有化服务器上执行：

```bash
bash scripts/update.sh
```

---

## 2026.05.21-private.2

### 变更

**Android SDK**
- 版本升级至 `1.0.1`，新增 `serverUrl` 参数
- `XuqmSDK.initialize(context, appKey, serverUrl = "https://your-server.com")` 可使用指定私有化服务地址完成初始化

### 升级方法

在私有化服务器上执行：

```bash
bash scripts/update.sh
```

升级脚本会自动拉取最新镜像并重启受影响容器，全程无需停机迁移。

---

## 2026.05.21-private.1

- 新增 `scripts/reset.sh` 容器重置脚本，解决 nginx 502 / crash-loop / 镜像不生效等问题
- 完善故障排查文档（`docs/runbook.md`）
- 修正各服务端口文档

---

## 2026.05.18-private.1

- 初始版本