山东大学软件学院项目实训-基于大模型的模拟面试系统-个人主页头像上传

采用图床的方案,存储用户头像。

实现步骤

引入OSS依赖

在我们的SpringBoot项目中引入OSS依赖

cpp 复制代码
<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.10.2</version>
</dependency>

配置 OSSClient

java 复制代码
package com.sdumagicode.backend.config;

import com.aliyun.oss.OSSClient;
import com.aliyun.oss.OSSClientBuilder;
import io.github.cdimascio.dotenv.Dotenv;
import lombok.Data;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Data
@Configuration
public class OSSUploadConfig {
    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;
    private String maxSize;
    private String prefix;

    public OSSUploadConfig() {
        Dotenv dotenv = Dotenv.configure().load();
        this.endpoint = dotenv.get("ALIYUN_OSS_ENDPOINT");
        this.accessKeyId = dotenv.get("ALIYUN_OSS_ACCESS_KEY_ID");
        this.accessKeySecret = dotenv.get("ALIYUN_OSS_ACCESS_KEY_SECRET");
        this.bucketName = dotenv.get("ALIYUN_OSS_BUCKET_NAME");
        this.maxSize = dotenv.get("ALIYUN_OSS_MAX_SIZE");
        this.prefix = dotenv.get("ALIYUN_OSS_DIR_PREFIX");
    }

    @Bean
    public OSSClient createOssClient() {
        return (OSSClient) new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
    }
}

配置信息在.env文件里:

java 复制代码
# .env 文件(注意:不要加引号)
ALIYUN_OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
ALIYUN_OSS_ACCESS_KEY_ID=your-access-key-id
ALIYUN_OSS_ACCESS_KEY_SECRET=your-access-key-secret
ALIYUN_OSS_BUCKET_NAME=your-bucket-name
ALIYUN_OSS_MAX_SIZE=10MB
ALIYUN_OSS_DIR_PREFIX=uploads/

因为Spring Boot 默认不直接支持 .env 文件,所以需要使用 dotenv 库来加载它。

cpp 复制代码
<dependency>
    <groupId>io.github.cdimascio</groupId>
    <artifactId>dotenv-java</artifactId>
    <version>3.0.0</version>
</dependency>

完成上述代码后,我们就可以在其他类中上传图片到阿里云图床了。

调用实例

首先,根据前端传来的是一个base64编码的图片,于是定义了一个工具类专门处理该图片并将其上传到阿里云图床。

java 复制代码
package com.sdumagicode.backend.util;

import com.aliyun.oss.OSSClient;
import com.aliyun.oss.model.PutObjectRequest;
import com.sdumagicode.backend.config.OSSUploadConfig;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.io.ByteArrayInputStream;
import java.util.Base64;
import java.util.UUID;

@Service
public class OSSUpload {
    private final OSSClient ossClient;
    private final OSSUploadConfig ossConfig;

    @Autowired
    public OSSUpload(OSSClient ossClient, OSSUploadConfig ossConfig) {
        this.ossClient = ossClient;
        this.ossConfig = ossConfig;
    }

    public String uploadBase64ToOSS(String base64Data, String folder) {
        try {
            // 1. 检查 Base64 数据
            if (base64Data == null || !base64Data.startsWith("data:image/")) {
                throw new IllegalArgumentException("Base64 数据格式不正确");
            }

            // 2. 解析 Base64
            String[] parts = base64Data.split(",");
            String header = parts[0]; // data:image/png;base64
            String data = parts[1];   // 实际数据

            // 3. 获取文件扩展名
            String extension = header.split(";")[0].split("/")[1];

            // 4. 生成唯一文件名
            String fileName = folder + UUID.randomUUID() + "." + extension;

            // 5. 解码并上传
            byte[] bytes = Base64.getDecoder().decode(data);
            ossClient.putObject(
                    ossConfig.getBucketName(),
                    fileName,
                    new ByteArrayInputStream(bytes)
            );

            // 6. 返回访问 URL
            return "https://" + ossConfig.getBucketName() + "." + ossConfig.getEndpoint() + "/" + fileName;
        } catch (Exception e) {
            throw new RuntimeException("上传图片到 OSS 失败: " + e.getMessage(), e);
        }
    }
}

之后,修改UserServiceImpl.java文件里保存图片URL的部分:

java 复制代码
@Autowired
private OSSUpload ossUpload;

...

if (FileDataType.BASE64.equals(user.getAvatarType())) {
    // 1. 上传Base64图片到OSS
    String ossUrl = ossUpload.uploadBase64ToOSS(user.getAvatarUrl(), "avatars/");
    // 2. 更新用户信息
    user.setAvatarUrl(ossUrl);
    user.setAvatarType("0"); // 假设"0"表示URL类型
}

图片成功上传到阿里云,并且可以在用户端正常显示。

遇到的问题

dotenv版本不匹配

java 复制代码
java: cannot access io.github.cdimascio.dotenv.Dotenv
  bad class file: /Users/leeson/.m2/repository/io/github/cdimascio/dotenv-java/3.0.0/dotenv-java-3.0.0.jar!/io/github/cdimascio/dotenv/Dotenv.class
    class file has wrong version 55.0, should be 52.0
    Please remove or make sure it appears in the correct subdirectory of the classpath.

这个错误是因为 Java 版本不兼容.class 文件的版本 55.0 对应 Java 11 ,而项目使用的是 Java 8 (版本 52.0),导致无法加载该类。

解决方案

降级 dotenv-java(兼容 Java 8)

xml 复制代码
<dependency>
    <groupId>io.github.cdimascio</groupId>
    <artifactId>dotenv-java</artifactId>
    <version>2.3.2</version> <!-- 支持 Java 8 的版本 -->
</dependency>

修改之后,项目成功地跑了起来。

相关推荐
浪裡遊2 分钟前
Sass详解:功能特性、常用方法与最佳实践
开发语言·前端·javascript·css·vue.js·rust·sass
TDengine (老段)7 分钟前
使用 StatsD 向 TDengine 写入
java·大数据·数据库·时序数据库·iot·tdengine·涛思数据
真实的菜9 分钟前
JVM类加载系统详解:深入理解Java类的生命周期
java·开发语言·jvm
N_NAN_N37 分钟前
类图+案例+代码详解:软件设计模式----原型模式
java·设计模式·原型模式
佛祖保佑永不宕机41 分钟前
maven引入本地jar包
java·maven·jar
默默coding的程序猿1 小时前
3.前端和后端参数不一致,后端接不到数据的解决方案
java·前端·spring·ssm·springboot·idea·springcloud
在未来等你1 小时前
JVM调优实战 Day 15:云原生环境下的JVM配置
java·jvm·性能优化·虚拟机·调优
funnycoffee1231 小时前
Huawei 6730 Switch software upgrade example版本升级
java·前端·华为
Java初学者小白1 小时前
秋招Day15 - Redis - 缓存设计
java·数据库·redis·缓存
缘来是庄1 小时前
设计模式之组合模式
java·设计模式·组合模式