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

Aberta Para iniciantes
#14,456 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
76/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
docker, go
Domínio
backend, databases

Direção de pesquisa

Comece em agent/app/service/app_utils.go, em handleUpgradeCompose, por volta da linha 691; depois compare a busca do serviço com a busca protegida por volta das linhas 701–712. Verifique o fluxo dos apps instalados por meio de isEditCompose e PageWithContext para entender como o erro é tratado. O trabalho estará concluído quando um valor de serviço ausente ou inválido retornar o erro de análise existente em vez de causar um panic; a API de apps instalados não deverá mais retornar 500 nesse caso.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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 自身产生并维护这组不一致。

Linguagem predominante
Go
Estrelas
37.4k
Forks
3.4k
Merge médio
8h 53min
PRs com merge (30d)
179

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de 1Panel-dev/1Panel

Todas as issues de 1Panel-dev/1Panel

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.