Spring中@Service类构造方法无法注入String的解决办法

我有一个通过Web前端为用户提供文件服务的Spring Boot应用，用户可浏览Dropbox、本地文件系统等多种文件后端并将文件添加到个人库。以下是查询Dropbox API的服务层部分代码：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import okhttp3.*;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

@Service
public class DbxService {

    private final String dropboxApiAccessToken;
    private final OkHttpClient httpClient;
    private final String dropboxApiAccessTokenFilePath;
    private final ObjectMapper jsonObjectMapper; //fasterxml.jackson.databind.ObjectMapper

    DbxService(String dropboxApiAccessTokenFilePath) throws IOException {
        this.dropboxApiAccessTokenFilePath = dropboxApiAccessTokenFilePath;
        this.httpClient = new OkHttpClient();
        this.jsonObjectMapper = new ObjectMapper();
        this.dropboxApiAccessToken = Files.readString(Path.of(dropboxApiAccessTokenFilePath));
    }

    public String listDropboxDirectory(String path) throws IOException {
        //jackson.databind.node.ObjectNode
        ObjectNode jsonPostRequestNode = jsonObjectMapper.createObjectNode();
        //need JSON string {"path": "[path]"} for Dropbox API Post request
        jsonPostRequestNode.put("path", path);

        //okhttp3 request
        Request dropboxApiRequest = new Request.Builder()
                .url("https://api.dropboxapi.com/2/files/list_folder")
                .post(RequestBody.create(jsonPostRequestNode.asText(), MediaType.parse("application/json")))
                .addHeader("Authorization", "Bearer " + this.dropboxApiAccessToken)
                .addHeader("Content-Type", "application/json")
                .build();
        Response dropboxApiResponse = this.httpClient.newCall(dropboxApiRequest).execute();
        return dropboxApiResponse.body().string();
    }
}

该类因不可变而线程安全，作为单例无问题，我希望仅在配置类中定义Dropbox API令牌文件路径，而非硬编码到字段中，但上述代码报错：Could not autowire. No beans of 'String' type found.。经调研，Spring无法注入非Spring Bean的对象，请问如何重构该服务类以解决此错误？

方法1：用@Value直接注入配置值 #

如果令牌文件路径在application.properties/application.yml中配置（比如dropbox.token-file-path=/path/to/token.txt），可以直接通过@Value注入路径，调整构造器如下：

@Service
public class DbxService {

    private final String dropboxApiAccessToken;
    private final OkHttpClient httpClient;
    private final ObjectMapper jsonObjectMapper;

    public DbxService(@Value("${dropbox.token-file-path}") String dropboxApiAccessTokenFilePath) throws IOException {
        this.httpClient = new OkHttpClient();
        this.jsonObjectMapper = new ObjectMapper();
        this.dropboxApiAccessToken = Files.readString(Path.of(dropboxApiAccessTokenFilePath));
    }

    // 省略listDropboxDirectory方法...
}

方法2：配置类定义带限定符的String Bean #

若要在配置类中显式定义路径，需给String Bean添加@Qualifier，避免Spring无法区分多个String类型Bean：

第一步：编写配置类

@Configuration
public class DropboxConfig {

    @Bean
    @Qualifier("dropboxTokenFilePath")
    public String dropboxTokenFilePath() {
        // 可直接写路径，或从配置文件读取后返回
        return "/path/to/your/dropbox-token.txt";
    }
}

第二步：修改DbxService构造器指定注入Bean

@Service
public class DbxService {

    private final String dropboxApiAccessToken;
    private final OkHttpClient httpClient;
    private final ObjectMapper jsonObjectMapper;

    public DbxService(@Qualifier("dropboxTokenFilePath") String dropboxApiAccessTokenFilePath) throws IOException {
        this.httpClient = new OkHttpClient();
        this.jsonObjectMapper = new ObjectMapper();
        this.dropboxApiAccessToken = Files.readString(Path.of(dropboxApiAccessTokenFilePath));
    }

    // 省略listDropboxDirectory方法...
}

方法3：配置属性绑定（Spring Boot规范方式） #

适合多配置项场景，扩展性更强：

第一步：编写配置属性类

@ConfigurationProperties(prefix = "dropbox")
public class DropboxProperties {
    private String tokenFilePath;

    // getter、setter
    public String getTokenFilePath() {
        return tokenFilePath;
    }

    public void setTokenFilePath(String tokenFilePath) {
        this.tokenFilePath = tokenFilePath;
    }
}

第二步：启用配置属性

@Configuration
@EnableConfigurationProperties(DropboxProperties.class)
public class DropboxConfig {
}

第三步：注入配置属性类到DbxService

@Service
public class DbxService {

    private final String dropboxApiAccessToken;
    private final OkHttpClient httpClient;
    private final ObjectMapper jsonObjectMapper;

    public DbxService(DropboxProperties dropboxProperties) throws IOException {
        this.httpClient = new OkHttpClient();
        this.jsonObjectMapper = new ObjectMapper();
        this.dropboxApiAccessToken = Files.readString(Path.of(dropboxProperties.getTokenFilePath()));
    }

    // 省略listDropboxDirectory方法...
}

额外优化建议 #

• 将OkHttpClient和ObjectMapper交由Spring管理为单例Bean，避免重复创建实例：

  @Configuration
  public class AppConfig {
      @Bean
      public OkHttpClient okHttpClient() {
          return new OkHttpClient();
      }
  
      @Bean
      public ObjectMapper objectMapper() {
          return new ObjectMapper();
      }
  }
  

  调整DbxService构造器注入：

  public DbxService(DropboxProperties dropboxProperties, OkHttpClient httpClient, ObjectMapper objectMapper) throws IOException {
      this.httpClient = httpClient;
      this.jsonObjectMapper = objectMapper;
      this.dropboxApiAccessToken = Files.readString(Path.of(dropboxProperties.getTokenFilePath()));
  }
  

• 捕获令牌文件读取异常（如文件不存在、权限不足），封装为自定义异常抛出，避免直接暴露底层IOException。

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