[Bug] Failed to upgrade Meilisearch to v1.53 from the App Store: the template uses the deprecated MEILI_EXPERIMENTAL_DUMPLESS_UPGRADE environment variable

[LHY0125]

Contact Information

No response

1Panel Version

v2.x (meilisearch 应用版本: v1.53.0;升级失败时数据版本 v1.52.0)

Problem Description

从 1Panel 应用商店将 meilisearch 从 v1.52.0 升级到 v1.53.0 失败并自动回滚。升级过程中容器反复崩溃、重启 3 次,1Panel 判定"应用未就绪"后自动回滚到 v1.52.0。2026-08-14 当天多次尝试(11:33 / 11:39 / 21:29 / 21:49)均同样失败。

Steps to Reproduce

1. 应用商店安装 meilisearch v1.52.0(有索引数据)
2. 应用商店 → meilisearch → 升级到 v1.53.0
3. 等待应用就绪失败(容器重启 count 0→3),1Panel 自动回滚

The expected correct result

升级成功,数据库从 1.52.0 自动迁移到 1.53.0,应用正常启动。

Related log output

1Panel 升级任务日志:

2026/08/14 21:29:34 升级应用 [meilisearch] 任务开始 [START]
2026/08/14 21:29:34 开始拉取镜像 [getmeili/meilisearch:v1.53.0]
2026/08/14 21:29:38 拉取镜像 成功
2026/08/14 21:29:38 准备应用升级 成功
2026/08/14 21:29:38 开始停止原应用
2026/08/14 21:29:39 停止原应用 成功
2026/08/14 21:29:39 开始备份
2026/08/14 21:29:40 开始压缩目录
2026/08/14 21:29:40 压缩目录成功，压缩为 upgrade_backup_meilisearch_20260814212939d26sx.tar.gz
2026/08/14 21:29:40 开始执行 upgrade 脚本
2026/08/14 21:29:40 执行 upgrade 脚本 成功
2026/08/14 21:29:40 开始启动 应用
2026/08/14 21:29:40 启动 应用 成功
2026/08/14 21:29:40 开始等待应用就绪
2026/08/14 21:29:41 等待应用就绪 失败 : container meilisearch is not ready: container restart count changed from 0 to 3 during startup
2026/08/14 21:29:41 升级应用 [meilisearch] 失败: container meilisearch is not ready: container restart count changed from 0 to 3 during startup
2026/08/14 21:29:41 开始应用 meilisearch 回滚
2026/08/14 21:29:42 开始解压文件 app.tar.gz
2026/08/14 21:29:42 解压文件 app.tar.gz 成功
2026/08/14 21:29:52 应用 meilisearch 回滚 成功
2026/08/14 21:29:53 [TASK-END]

容器自身日志(升级时 v1.53.0 容器反复崩溃的真实报错):

ERROR meilisearch: error=Your database version (1.52.0) is incompatible with your current engine version (1.53.0).
To migrate data between Meilisearch versions, please follow our guide on https://www.meilisearch.com/docs/learn/update_and_migration/updating.
Alternatively, you can set the `--upgrade-db` flag (or the `MEILI_UPGRADE_DB` environment variable) to upgrade the database on startup.

Root Cause 分析(供参考)

1Panel-dev/appstore 仓库中 meilisearch 模板的 docker-compose.yml(包括最新版本 1.53.1)使用的是:

environment:
  MEILI_EXPERIMENTAL_DUMPLESS_UPGRADE: true

该变量在 Meilisearch v1.53.0 中已被移除/废弃。Meilisearch 官方要求跨版本升级数据库需设置 MEILI_UPGRADE_DB: true(或 --upgrade-db)。由于旧变量不再被识别,引擎启动时检测到数据库版本不兼容直接报错退出(exit code 1),在 restart: always 下反复拉起,最终被 1Panel 判定未就绪并回滚。

已本地验证:将环境变量手动改为 MEILI_UPGRADE_DB: true 后,数据库可成功从 1.52.0 迁移到 1.53.0,索引完整保留,应用正常启动。

建议修复

将模板 compose 中 MEILI_EXPERIMENTAL_DUMPLESS_UPGRADE: true 修改为 MEILI_UPGRADE_DB: true。

关联

与已关闭的 #11311 为同一问题(同为"数据库版本不兼容"导致升级后崩溃重启)。#11311 中官方曾回复"会在最新版本中增加该环境变量",但最新 1.53.1 模板仍未修复。

[zhengkunwang223]

好的 我们修复一下