xiaoxia-saas/apps/api/app/core/storage.py

"""阿里云 OSS 存储服务"""

import logging
import os
from urllib.parse import urlparse

try:
    import oss2
except ImportError:  # pragma: no cover - exercised in minimal local/test environments
    oss2 = None
from app.config import get_settings

logger = logging.getLogger(__name__)


class OSSStorageService:
    """阿里云 OSS 存储服务"""

    def __init__(self):
        settings = get_settings()
        self.bucket_name = settings.OSS_BUCKET_NAME
        self.public_url = f"https://{settings.OSS_BUCKET_NAME}.{settings.OSS_ENDPOINT}"
        self.local_url_prefix = os.getenv("GENERATED_FILES_URL_PREFIX", "/generated-files")
        self.bucket = None

        if settings.OSS_ACCESS_KEY_ID and settings.OSS_ACCESS_KEY_SECRET:
            if oss2 is None:
                raise RuntimeError("oss2 is required when OSS credentials are configured")
            auth = oss2.Auth(
                settings.OSS_ACCESS_KEY_ID,
                settings.OSS_ACCESS_KEY_SECRET,
            )
            self.bucket = oss2.Bucket(
                auth,
                settings.OSS_ENDPOINT,
                settings.OSS_BUCKET_NAME,
            )

    def _is_local_generated_url(self, storage_key_or_url: str) -> bool:
        parsed = urlparse(storage_key_or_url)
        path = parsed.path if parsed.scheme else storage_key_or_url
        return path.startswith(f"{self.local_url_prefix}/")

    def upload_file(
        self,
        file_or_path,
        storage_key: str,
        content_type: str = "application/octet-stream",
    ) -> str:
        """
        上传文件到 OSS

        Args:
            file_or_path: 文件对象或本地文件路径
            storage_key: 存储键（文件路径）
            content_type: 内容类型

        Returns:
            文件公网 URL
        """
        if self.bucket is None:
            raise RuntimeError("OSS storage is not configured")

        try:
            # 如果是字符串路径，从本地文件上传
            if isinstance(file_or_path, str):
                self.bucket.put_object_from_file(storage_key, file_or_path, headers={"Content-Type": content_type})
            else:
                # 文件对象
                file_or_path.seek(0)
                self.bucket.put_object(storage_key, file_or_path, headers={"Content-Type": content_type})

            return f"{self.public_url}/{storage_key}"
        except Exception as e:
            raise Exception(f"Failed to upload file to OSS: {e}")

    def get_url(self, storage_key: str) -> str:
        """获取文件公网 URL"""
        return f"{self.public_url}/{storage_key}"

    def get_download_url(self, storage_key_or_url: str, expires_seconds: int = 3600) -> str:
        """
        获取文件下载签名 URL（用于私有文件）

        Args:
            storage_key_or_url: 存储键或完整 URL
            expires_seconds: 过期时间（秒）

        Returns:
            签名 URL
        """
        if self.bucket is None:
            if self._is_local_generated_url(storage_key_or_url):
                return storage_key_or_url
            return self.get_url(self._normalize_storage_key(storage_key_or_url))

        storage_key = self._normalize_storage_key(storage_key_or_url)
        try:
            return self.bucket.sign_url("GET", storage_key, expires_seconds)
        except Exception:
            return self.get_url(storage_key)

    def _normalize_storage_key(self, storage_key_or_url: str) -> str:
        """从 URL 中提取存储键"""
        if storage_key_or_url.startswith("http://") or storage_key_or_url.startswith("https://"):
            parsed = urlparse(storage_key_or_url)
            # 移除开头的 /
            return parsed.path.lstrip("/")
        return storage_key_or_url.lstrip("/")

    def download_file(self, storage_key: str, local_path: str):
        """
        从 OSS 下载文件到本地

        Args:
            storage_key: 存储键
            local_path: 本地文件路径
        """
        if self.bucket is None:
            raise RuntimeError("OSS storage is not configured")

        try:
            os.makedirs(os.path.dirname(local_path), exist_ok=True)
            self.bucket.get_object_to_file(storage_key, local_path)
        except Exception as e:
            raise Exception(f"Failed to download file from OSS: {e}")

    def delete_file(self, storage_key: str):
        """
        删除 OSS 文件

        Args:
            storage_key: 存储键
        """
        if self.bucket is None:
            return

        try:
            self.bucket.delete_object(storage_key)
        except Exception as error:
            logger.warning(
                "Failed to delete file from OSS",
                extra={"storage_key": storage_key, "error": str(error)},
            )

    def file_exists(self, storage_key: str) -> bool:
        """
        检查文件是否存在

        Args:
            storage_key: 存储键

        Returns:
            是否存在
        """
        if self.bucket is None:
            return False
        return self.bucket.object_exists(storage_key)


# 向后兼容的服务类名
MinIOService = OSSStorageService


_storage_service = None


def get_storage_service() -> OSSStorageService:
    """获取存储服务实例（全局单例）"""
    global _storage_service
    if _storage_service is None:
        _storage_service = OSSStorageService()
    return _storage_service


# 向后兼容的别名
def get_minio_service() -> OSSStorageService:
    """向后兼容：返回 OSS 服务（已替换 MinIO）"""
    return get_storage_service()