在上云 API 2 的管理后台配置三方 Minio 后媒体管理航线管理异常

说明：本文档中，应用运行与设备管控底座以下统一简称为底座。

问题现象

将 MinIO 部署在独立服务器（与上云 API 2 底座的后端服务不在同一台服务器），AIO 管理后台「存储桶设置」已切换为「自托管 S3 协议存储」并保存后，出现以下异常：

设备执行航线任务后，文件已成功上传到外部 MinIO ✅

但 listenMediaFileDeviceUploadMessage 始终没有触发 ❌

pf-media-core 日志报错：250012 source not found

创建航线的时候报错，不能创建航线

⚠️ 注意：此问题仅出现在外部 MinIO 跨服务器部署场景。使用平台内置 MinIO 不受影响。

问题原因

问题链路：

用户在 AIO 切换外部 MinIO 并保存
        ↓
STS 临时凭证已切换，设备将文件上传到外部 MinIO ✅
        ↓
pf-media-core 收到 upload-callback
        ↓
做 HeadObject 验证文件时，OBJECT_STORAGE_REGION 为空或不匹配
        ↓
文件找不到 → 250012 source not found → 回传不触发 ❌

关键根因：OBJECT_STORAGE_REGION 必须设置为 us-east-1

MinIO 默认使用 us-east-1 作为 region，如果 env 里该字段为空或不一致，pf-media-core 做 HeadObject 验证时会因 region 不匹配而失败，导致回调链路中断。

解决步骤

第一步：AIO 管理后台配置存储桶

打开 AIO 管理后台（http://<底座服务器IP>:30888），进入「上云管理」→「存储桶设置」，填写以下信息并保存：

字段	值
存储桶类型	自托管 S3 协议存储
存储桶 AK	MinIO 用户名（如 `dji`）
存储桶 SK	MinIO 密码
EndPoint	`http://<MinIO_IP>:9000`
Region	`us-east-1`（必填，不能为空！）

点击「连通检测」确认显示「连通成功」后，点击「保存」。

第二步：修改 env 文件补充 Region 配置

第三步：执行 setuptools restart 使配置生效

⚠️ 注意：必须执行 ./setuptools restart，不能只 docker restart pf-media-core，因为需要 config_tool 重新渲染所有配置文件。

第四步：验证配置是否生效

预期输出中看到 region: us-east-1：

第五步：验证外部 MinIO 存储桶存在

如果桶不存在，手动创建：

第六步：重新测试回传

让设备执行一次航线任务，验证 listenMediaFileDeviceUploadMessage 是否触发。

验证 pf-media-core 日志不再出现 250012：

注意事项

Region 必须填 us-east-1：MinIO 默认 region 为 us-east-1，不能为空，不能填其他值

两处都要改：env 文件 + AIO 管理后台存储桶设置，缺一不可

必须用 ./setuptools restart：让 config_tool 重新渲染 pf-media-core 的配置文件，单独 docker restart 无效

在上云 API 2 的管理后台配置三方 Minio 后媒体管理航线管理异常

问题现象#

问题原因#

解决步骤#

第一步：AIO 管理后台配置存储桶#

第二步：修改 env 文件补充 Region 配置#

第三步：执行 setuptools restart 使配置生效#

第四步：验证配置是否生效#

第五步：验证外部 MinIO 存储桶存在#

第六步：重新测试回传#

注意事项#