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

Đang mở Phù hợp với người mới
#14,456 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

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
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, go
Lĩnh vực
backend, databases

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ả

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

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

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của 1Panel-dev/1Panel

Tất cả issue của 1Panel-dev/1Panel

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.