Skip to content

[Bug] 应用商店升级 meilisearch v1.53 失败:模板使用已废弃的环境变量 MEILI_EXPERIMENTAL_DUMPLESS_UPGRADE #13556

Description

@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 模板仍未修复。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions