Django+S3/CloudFront部署后图片URL出现双https://问题求助

针对生产环境（AWS EC2）中Django DRF返回的图片/静态文件URL出现重复https://的问题，以下是逐一排查和解决步骤：

1. 检查settings.py核心配置 #

这是最常见的触发点，重点关注媒体/静态URL和S3相关配置：

• 错误示例：MEDIA_URL/STATIC_URL带完整协议，与django-storages自动生成的协议重复

  # 错误配置
  MEDIA_URL = "https://d2to87w45k79nd.cloudfront.net/media/"
  AWS_S3_CUSTOM_DOMAIN = "https://d2to87w45k79nd.cloudfront.net"
  

• 正确配置：去掉协议前缀，或使用相对协议

  # 方案1：使用相对协议
  MEDIA_URL = "//d2to87w45k79nd.cloudfront.net/media/"
  STATIC_URL = "//d2to87w45k79nd.cloudfront.net/static/"
  AWS_S3_CUSTOM_DOMAIN = "d2to87w45k79nd.cloudfront.net"
  
  # 方案2：仅保留路径，让storages自动拼接完整URL
  MEDIA_URL = "/media/"
  STATIC_URL = "/static/"
  AWS_S3_CUSTOM_DOMAIN = "d2to87w45k79nd.cloudfront.net"
  

• 额外检查AWS_S3_URL_PROTOCOL：若设置该值，需用"https:"而非"https://"

  AWS_S3_URL_PROTOCOL = "https:"
  

2. 排查自定义存储类（storages.py） #

如果继承了S3Boto3Storage自定义存储类，确保custom_domain字段不带协议：

# 错误配置
class MediaStorage(S3Boto3Storage):
    custom_domain = "https://d2to87w45k79nd.cloudfront.net"

# 正确配置
class MediaStorage(S3Boto3Storage):
    custom_domain = "d2to87w45k79nd.cloudfront.net"
    location = "media"

3. 序列化层（serializers.py）检查 #

确认未在序列化时手动重复拼接协议：

• 错误示例：误用build_absolute_uri拼接已带协议的S3 URL

  class TestimonySerializer(serializers.ModelSerializer):
      image = serializers.SerializerMethodField()
      def get_image(self, obj):
          # 此处会导致重复https://
          return self.context['request'].build_absolute_uri(obj.image.url)
  

• 正确做法：直接返回S3生成的完整URL

  class TestimonySerializer(serializers.ModelSerializer):
      image = serializers.SerializerMethodField()
      def get_image(self, obj):
          return obj.image.url  # 确保该URL本身无重复协议
  

4. EC2反向代理/负载均衡配置 #

如果EC2前端有Nginx或ELB，需确保Django能正确识别请求协议：

• Nginx配置中添加转发头：

  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-Host $host;
  

• Djangosettings.py中开启代理头识别：

  SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
  USE_X_FORWARDED_HOST = True
  

5. 依赖版本升级 #

旧版django-storages可能存在协议拼接bug，升级到最新稳定版：

pip install --upgrade django-storages boto3

内容的提问来源于stack exchange，提问作者Kushagra Gupta