[BUG] v2.5.1 Installed Apps API panic: handleUpgradeCompose performs an unchecked type assertion on a missing service key (app_utils.go:691)

オープン 初心者向け
#14,456 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
76/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
docker, go
領域
backend, databases

調査の方向性

agent/app/service/app_utils.go の handleUpgradeCompose(691行目付近)から始め、そのサービス検索を701~712行目付近のガード付き検索と比較してください。isEditCompose と PageWithContext を通るインストール済みアプリの処理経路を確認し、エラーがどのように処理されるかを把握してください。サービス値が欠落または無効な場合に panic を起こさず、既存の parse error を返せば完了です。このケースでインストール済みアプリの API が 500 を返さなくなる必要があります。

索引モデルが issue の本文から書いたものです。

説明

type: optimization

环境信息

  • 1Panel 版本:v2.5.1(agent 自动升级,模式 stable)
  • 复现场景:生产环境(Docker 多应用安装)

现象

应用商店页面顶部持续弹出「服务异常」,已安装应用列表接口(POST /api/v2/apps/installed/search,即 AppInstallService.PageWithContext)返回 500。agent 日志中每次打开该页面都新增一条 panic(共捕获 4 次,gin recovery 兜底不崩进程)。

panic 栈

interface conversion: interface {} is nil, not map[string]interface {}
runtime/iface.go:293
agent/app/service/app_utils.go:691
agent/app/service/app_utils.go:775
agent/app/service/app_utils.go:2417   // isEditCompose
agent/app/service/app_utils.go:1712
agent/app/service/app_install.go:133
agent/app/service/app_install.go:80   // PageWithContext
agent/app/api/v2/app_install.go:35    // Page

复现条件

同时满足以下三点即 100% 复现:

  1. 某已装应用的 app_details.docker_compose 非空(本地应用包应用);
  2. 该 compose 的 services 下不包含与 app_installs.service_name 同名的服务键(多服务 compose + service_name 与所有服务键不同名时触发);
  3. 打开应用商店「已安装」列表(isEditCompose 对每个已装应用计算 compose 是否被手改过)。

真实触发案例:本地应用包含 4 个服务(android-signer / android-sign-proxy / android-pad-signer / android-pad-sign-proxy),而 service_name 记录为安装名 qqjiasu-android-signer(与应用 key 同名、compose 中无此键)。

根因

handleUpgradeCompose 中第 691 行对取值结果裸断言、未判空:

serviceValue := servicesMap[install.ServiceName].(map[string]interface{})  // 691 行:键不存在时值为 nil,直接 panic

对比同一函数内对旧 compose 的取值(701–712 行)有完整的 ok 判断与 ErrFileParse 兜底,691 行缺少同样的保护。len(servicesMap) == 1 的分支会做服务名重命名映射,但 len > 1 时直接落到 691 行,不校验 install.ServiceName 是否存在于 servicesMap。

建议修复

691 行按 709 行同款写法补判空:

serviceValueInterface, ok := servicesMap[install.ServiceName]
if !ok || serviceValueInterface == nil {
    return nil, buserr.New("ErrFileParse")
}
serviceValue, ok := serviceValueInterface.(map[string]interface{})
if !ok {
    return nil, buserr.New("ErrFileParse")
}

这样 isEditCompose 会按既有语义在 rawCompose == "" || err != nil 时返回 false,列表接口不再 500。

影响面

任何「compose 服务键与 service_name 不同名」的已装应用都会让整个已安装列表接口持续 500(前端表现为应用商店页「服务异常」弹窗),升级检查与面板升级入口同样不可用。侧写说明:这不是数据非法——service_name 在安装时可能取安装名而非服务键(多服务 compose 场景),1Panel 自身产生并维护这组不一致。

主要言語
Go
スター
37.4k
フォーク
3.4k
平均マージ
8時間 53分
マージ済み PR(30日)
179

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

1Panel-dev/1Panel のほかの issue

1Panel-dev/1Panel の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。