@Value注解注入失败返回null，配置无法填充至DataBucketUtil变量

运行代码时，application.properties中的外部配置无法填充到DataBucketUtil类的变量中，@Value注解无法正常取值，返回null。已确认存在操作疏漏，但无法定位问题。相关代码与配置如下：

DataBucketUtil类代码 #

public class DataBucketUtil {

private static final Logger logger = LoggerFactory.getLogger(DataBucketUtil.class);

@Value("${gcp.config.file}")
private String gcpConfigFile;

@Value("${gcp.project.id}")
private String gcpProjectId;

@Value("${gcp.bucket.id}")
private String gcpBucketId;

@Value("${gcp.directory.name}")
private String gcpDirectoryName;

/**
 * 上传文件到GCS
 *
 * @param multipartFile-
 * @param fileName-
 * @param contentType-
 * @return -
 */
public FileDto uploadFile(MultipartFile multipartFile, String fileName, String contentType) {
    try {
        logger.debug("开始在GCS上上传文件");
        byte[] fileData = FileUtils.readFileToByteArray(convertFile(multipartFile));
        InputStream inputStream = new ClassPathResource(gcpConfigFile).getInputStream();

        StorageOptions options = StorageOptions.newBuilder().setProjectId(gcpProjectId)
                .setCredentials(GoogleCredentials.fromStream(inputStream)).build();

        Storage storage = options.getService();
        Bucket bucket = storage.get(gcpBucketId, Storage.BucketGetOption.fields());

        RandomString id = new RandomString(6, ThreadLocalRandom.current());
        Blob blob = bucket.create(gcpDirectoryName + "/"
                        + fileName + "-" + id.nextString() + checkFileExtension(fileName),
                fileData, contentType);

        if (blob != null) {
            logger.debug("文件成功上传到GCS");
            return new FileDto(blob.getName(), blob.getMediaLink());
        }
    } catch (IOException e) {
        logger.error("上传数据时发生错误。异常：", e);
        throw new RuntimeException("上传数据到GCS时发生错误");
    }
    throw new RuntimeException("上传数据到GCS时发生错误");
}

application.properties配置 #

gcp.config.file=gcp-config/gcs-prod-ho-finance.json
gcp.project.id=brac-main 
gcp.bucket.id=prod-ho-finance
gcp.dir.name=gs://prod-ho-finance

问题排查与解决方案 #

• 类未被Spring容器管理：DataBucketUtil类缺少Spring注解（如@Component、@Service），@Value仅对Spring容器中的Bean生效。需在类上添加@Component注解，并且通过@Autowired等方式注入实例，而非手动new对象。

• 配置键名不匹配：代码中使用${gcp.directory.name}，但配置文件中对应的键是gcp.dir.name，两者不一致导致注入失败。需统一键名，要么修改代码中的@Value为${gcp.dir.name}，要么修改配置文件为gcp.directory.name=gs://prod-ho-finance。

• 配置文件格式错误：原配置中gcp.project.id=brac-main gcp.bucket.id=prod-ho-finance写在同一行，会导致gcp.project.id的值被解析为brac-main gcp.bucket.id=prod-ho-finance，gcp.bucket.id无法被正确识别。需拆分为两行：

  gcp.project.id=brac-main
  gcp.bucket.id=prod-ho-finance
  

• 配置文件位置错误：确保application.properties放置在src/main/resources目录下，Spring Boot默认会加载该目录下的配置文件。

内容的提问来源于stack exchange，提问作者OUN Saif