[BUG] v2.5.1 Installed Apps API panic: handleUpgradeCompose performs an unchecked type assertion on a missing service key (app_utils.go:691)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 76/100
調査の方向性
agent/app/service/app_utils.go の handleUpgradeCompose(691行目付近)から始め、そのサービス検索を701~712行目付近のガード付き検索と比較してください。isEditCompose と PageWithContext を通るインストール済みアプリの処理経路を確認し、エラーがどのように処理されるかを把握してください。サービス値が欠落または無効な場合に panic を起こさず、既存の parse error を返せば完了です。このケースでインストール済みアプリの API が 500 を返さなくなる必要があります。
索引モデルが issue の本文から書いたものです。
説明
环境信息
- 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% 复现:
- 某已装应用的
app_details.docker_compose非空(本地应用包应用); - 该 compose 的
services下不包含与app_installs.service_name同名的服务键(多服务 compose + service_name 与所有服务键不同名时触发); - 打开应用商店「已安装」列表(
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
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
1Panel-dev/1Panel のほかの issue
-
[Bug] GPU Monitoring Not Detected対応中かも @wanghe-fit2cloud が今日担当しました。 オープンtype: question
1Panel-dev/1Panel#14454 · コメント 2 件 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
-
[Bug] Environment check: Intel GPU detection fails — xpu-smi JSON unmarshal error (memory_physical_size_byte type mismatch)対応中かも @wanghe-fit2cloud が今日担当しました。 オープンtype: optimization
1Panel-dev/1Panel#14453 · コメント 1 件 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
-
[Bug] Requests beyond the concurrency limit fail immediately instead of entering the queue (concurrency: 1, queue size: 50)対応中かも @wanghe-fit2cloud が今日担当しました。 オープンtype: ai-gateway
1Panel-dev/1Panel#14452 · コメント 1 件 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
-
[Feature] Optimize Network and Disk Configuration When Creating a Virtual Machine対応中かも @wanghe-fit2cloud が 3 日前に担当しました。 オープンtype: optimization
1Panel-dev/1Panel#14439 · コメント 1 件 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
-
[Bug] In the toolbox's disk management, disks in exFAT format cannot be mounted.対応中かも @wanghe-fit2cloud が 3 日前に担当しました。 オープンtype: to-be-verified
1Panel-dev/1Panel#14438 · コメント 1 件 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
1Panel-dev/1Panel の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
trufflesecurity/trufflehog#5573 ·
メンテナーはふだん 1 日以内に返信
-
Type/Improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 67/100
OpenNSW/nsw-srilanka#1259 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
katzenpost/katzenpost#1287 ·
メンテナーはふだん 2 日以内に返信
-
[Bug] AI 对话切换 Claude Code 必定 400「不支持的执行器」:assistantEngineClaude 与 executorModelCatalogs 键名不一致対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
Tencent/LoopForge#986 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信