[BUG] v2.5.1 Installed Apps API panic: handleUpgradeCompose performs an unchecked type assertion on a missing service key (app_utils.go:691)
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
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
环境信息
- 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 自身产生并维护这组不一致。
- Linguagem predominante
- Go
- Estrelas
- 37.4k
- Forks
- 3.4k
- Merge médio
- 8h 53min
- PRs com merge (30d)
- 179
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de 1Panel-dev/1Panel
-
[Bug] GPU Monitoring Not DetectedTalvez já em andamento @wanghe-fit2cloud assumiu hoje. Abertatype: question
1Panel-dev/1Panel#14454 · 2 comentários · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[Bug] Environment check: Intel GPU detection fails — xpu-smi JSON unmarshal error (memory_physical_size_byte type mismatch)Talvez já em andamento @wanghe-fit2cloud assumiu hoje. Abertatype: optimization
1Panel-dev/1Panel#14453 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[Bug] Requests beyond the concurrency limit fail immediately instead of entering the queue (concurrency: 1, queue size: 50)Talvez já em andamento @wanghe-fit2cloud assumiu há 1 dia. Abertatype: ai-gateway
1Panel-dev/1Panel#14452 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[Feature] Optimize Network and Disk Configuration When Creating a Virtual MachineTalvez já em andamento @wanghe-fit2cloud assumiu há 4 dias. Abertatype: optimization
1Panel-dev/1Panel#14439 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
[Bug] In the toolbox's disk management, disks in exFAT format cannot be mounted.Talvez já em andamento @wanghe-fit2cloud assumiu há 4 dias. Abertatype: to-be-verified
1Panel-dev/1Panel#14438 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
Todas as issues de 1Panel-dev/1Panel
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
trufflesecurity/trufflehog#5573 ·
Mantenedores costumam responder em até 1 dia
-
Type/Improvement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 67/100
OpenNSW/nsw-srilanka#1259 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
katzenpost/katzenpost#1287 ·
Mantenedores costumam responder em até 2 dias
-
C-bug O-community X-blathers-untriaged
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
cockroachdb/cockroach#176245 · 1 comentário ·