JFrog Artifactory跨K8s POD迁移：导出500错误及导入文件异常

一、导出时收到500内部错误但日志显示成功的排查与解决 #

原因分析 #

K8s环境下常见触发场景：

• Ingress/Service的超时配置过短，Artifactory后台已完成导出，但前端请求因超时返回500
• 导出文件生成后，POD内文件权限异常，导致Web服务无法读取返回给客户端，但导出流程本身已完成

解决步骤 #

• 调整K8s超时配置：检查Ingress（如Nginx Ingress）的proxy-read-timeout、proxy-connect-timeout参数，根据数据量延长至30分钟以上，避免请求提前中断
• 直接从POD获取导出文件：跳过Web界面，通过kubectl直接操作旧POD：

  # 进入旧Artifactory POD
  kubectl exec -it <old-artifactory-pod-name> -- bash
  # 默认导出路径为/var/opt/jfrog/artifactory/export/，确认文件存在
  ls /var/opt/jfrog/artifactory/export/
  # 拷贝ZIP到本地
  kubectl cp <old-artifactory-pod-name>:/var/opt/jfrog/artifactory/export/<export-file.zip> ./local-export.zip
  

• 验证文件完整性：本地执行unzip -t local-export.zip，确认无损坏、目录结构完整

二、导入时提示找不到artifactory.properties但文件实际存在的排查与解决 #

原因分析 #

• ZIP文件在传输/解压重压缩过程中损坏
• 新旧版本导出/导入的目录结构不兼容：7.15.4的导出结构与7.90.14的导入预期结构存在层级差异
• 导入操作时路径选择错误（如选中了ZIP内的子目录而非根目录）

解决步骤 #

• 重新校验ZIP完整性：用unzip -t <export-file.zip>检查，若有损坏则重新从旧POD拷贝
• 调整ZIP目录结构：确保artifactory.properties位于ZIP的根目录下，而非嵌套子目录。若结构不符，解压后将文件移至根目录，再重新压缩（注意用标准ZIP格式，避免额外压缩层级）
• 规范导入操作：在新实例导入界面选择ZIP文件后，确认导入源为ZIP的根目录，不要勾选子目录选项
• 尝试API导入：若界面导入仍有问题，用API指定导入参数：

  curl -u admin:<your-password> -X POST "http://<new-artifactory-url>/artifactory/api/system/import?system=true&async=false" -T <export-file.zip> -H "Content-Type: application/zip"
  

• 检查存储权限：确认新Artifactory POD对挂载的存储卷有读写权限，避免因权限不足无法读取ZIP内文件

内容的提问来源于stack exchange，提问作者Arc-sam