Label Studio中List标签访问S3预签名URL的解决方案

在使用Label Studio进行数据标注时，经常会遇到需要从S3存储中加载图片资源的情况。特别是在使用List标签展示多张图片时，开发者可能会遇到无法正确加载需要预签名的S3 URI的问题。

问题背景

Label Studio的List标签通常用于展示一组项目，比如在视觉排序任务中展示多张生成的图片。在官方示例中，图片资源通常通过静态URL直接引用。然而在实际生产环境中，出于安全考虑，我们更倾向于使用S3预签名URL来访问私有存储中的资源。

解决方案

经过实践验证，Label Studio的List标签确实支持使用需要预签名的S3 URI。关键点在于：

1. 正确的S3权限配置：确保S3存储桶已正确配置CORS策略，允许Label Studio域名访问资源
2. 预签名URL生成：Label Studio会自动处理S3 URI的预签名过程，前提是已正确配置AWS凭证
3. HTML嵌入方式：在List标签的数据结构中，使用标准的img标签格式嵌入图片

实现细节

当使用List标签时，可以按照以下格式组织数据：

{
  "images": [
    {
      "id": "image_1",
      "html": "<img src='s3://your-bucket/path/to/image1.png'/>"
    },
    {
      "id": "image_2",
      "html": "<img src='s3://your-bucket/path/to/image2.png'/>"
    }
  ]
}

Label Studio会自动将这些S3 URI转换为预签名URL，前提是：

1. AWS凭证已正确配置在Label Studio环境变量中
2. S3存储桶的CORS策略允许来自Label Studio域的请求
3. 用户有足够的权限访问这些S3资源

常见问题排查

如果遇到图片无法加载的情况，建议按以下步骤检查：

1. 确认S3存储桶的CORS配置是否正确
2. 检查Label Studio的AWS凭证配置
3. 验证直接使用预签名URL是否能访问图片
4. 检查浏览器开发者工具中的网络请求，查看具体的错误信息

最佳实践

对于生产环境部署，建议：

1. 为Label Studio创建专用的IAM角色，限制其只能访问必要的S3资源
2. 设置适当的预签名URL过期时间，平衡安全性和用户体验
3. 考虑使用CDN缓存频繁访问的图片资源，减轻S3压力
4. 实施监控机制，跟踪图片加载失败的情况

通过以上方法，可以确保Label Studio中的List标签能够可靠地展示来自S3的图片资源，同时保持系统的安全性。