[BUG] v2.5.1 Installed Apps API panic: handleUpgradeCompose performs an unchecked type assertion on a missing service key (app_utils.go:691)
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 76/100
Hướng nghiên cứu
Bắt đầu tại agent/app/service/app_utils.go, ở handleUpgradeCompose, khoảng dòng 691, rồi so sánh việc tra cứu dịch vụ ở đó với việc tra cứu có bảo vệ quanh các dòng 701–712. Kiểm tra luồng ứng dụng đã cài đặt qua isEditCompose và PageWithContext để hiểu lỗi được xử lý như thế nào. Hoàn thành khi giá trị dịch vụ bị thiếu hoặc không hợp lệ trả về lỗi phân tích cú pháp hiện có thay vì gây panic; API ứng dụng đã cài đặt không còn trả về 500 trong trường hợp này.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
环境信息
- 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 自身产生并维护这组不一致。
- Ngôn ngữ chính
- Go
- Star
- 37.4k
- Fork
- 3.4k
- Merge trung bình
- 8 giờ 53 phút
- Pull request đã merge (30 ngày)
- 179
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của 1Panel-dev/1Panel
-
[Bug] GPU Monitoring Not DetectedCó thể đã có người làm @wanghe-fit2cloud đã nhận hôm nay. Đang mởtype: question
1Panel-dev/1Panel#14454 · 2 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] Environment check: Intel GPU detection fails — xpu-smi JSON unmarshal error (memory_physical_size_byte type mismatch)Có thể đã có người làm @wanghe-fit2cloud đã nhận hôm nay. Đang mởtype: optimization
1Panel-dev/1Panel#14453 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] Requests beyond the concurrency limit fail immediately instead of entering the queue (concurrency: 1, queue size: 50)Có thể đã có người làm @wanghe-fit2cloud đã nhận hôm nay. Đang mởtype: ai-gateway
1Panel-dev/1Panel#14452 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Feature] Optimize Network and Disk Configuration When Creating a Virtual MachineCó thể đã có người làm @wanghe-fit2cloud đã nhận 3 ngày trước. Đang mởtype: optimization
1Panel-dev/1Panel#14439 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug] In the toolbox's disk management, disks in exFAT format cannot be mounted.Có thể đã có người làm @wanghe-fit2cloud đã nhận 4 ngày trước. Đang mởtype: to-be-verified
1Panel-dev/1Panel#14438 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của 1Panel-dev/1Panel
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
trufflesecurity/trufflehog#5573 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Type/Improvement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
OpenNSW/nsw-srilanka#1259 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
katzenpost/katzenpost#1287 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
C-bug O-community X-blathers-untriaged
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
cockroachdb/cockroach#176245 · 1 bình luận ·