Spring Boot使用${random.int}绑定SFTP端口到int类型失败求助

我尝试在.yml配置文件中使用port: ${random.int(1024, 65535)}生成随机端口，但启动时出现如下错误：

Could not bind properties to 'SftpConfiguration' : prefix=recon.data.load.sftp.*, ignoreInvalidFields=false, ignoreUnknownFields=true; nested exception is org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'recon.data.load.sftp.port' to int
at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor$AutowiredFieldElement.resolveFieldValue(AutowiredAnnotationBeanPostProcessor.java:6

我的配置类如下：

配置类SftpSpringConfiguration

@Configuration
public class SftpSpringConfiguration {
  @Bean
  @ConfigurationProperties(prefix = "recon.data.load.sftp.*")
  public SftpConfiguration sftpFileRetrievalConfiguration() {
    return new SftpConfiguration();
  }

  @Bean
  public SftpFileRetrieval fileRetrieval() {
    return new SftpFileRetrieval(sftpFileRetrievalConfiguration()::createSession);
  }
}

实体类SftpConfiguration

@NoArgsConstructor
@Getter
@Setter
public class SftpConfiguration {
  private String server;
  private String username;
  private Resource privateKey;
  private int port;
}

注：createSession是用于设置JSch客户端的标准模板代码。

硬编码端口值（如1024）时程序可正常工作，但使用${random.int(1024, 65535)}就会报错，希望实现随机端口的正常绑定，请问有什么解决思路？

1. 修正@ConfigurationProperties的前缀配置 #

你在@ConfigurationProperties中写的前缀recon.data.load.sftp.*是错误的，Spring Boot的配置前缀不需要通配符，应该改为recon.data.load.sftp。错误的前缀会导致Spring无法正确解析配置项，包括${random.int}表达式的处理逻辑。

修改后的代码：

@Bean
@ConfigurationProperties(prefix = "recon.data.load.sftp")
public SftpConfiguration sftpFileRetrievalConfiguration() {
  return new SftpConfiguration();
}

2. 确保Spring Boot随机值特性生效 #

Spring Boot的${random.*}表达式依赖于RandomValuePropertySource，这个特性默认在引入spring-boot-starter基础依赖后自动启用。检查你的项目依赖文件（pom.xml/build.gradle），确保已经引入了基础的Spring Boot Starter依赖，避免因依赖缺失导致特性失效。

3. 改用Integer类型替代int #

如果前缀修正后仍然报错，可以把SftpConfiguration中的private int port;改为private Integer port;。基本类型int无法接受null值，若表达式解析过程中出现临时未解析状态，可能触发绑定失败；包装类型Integer可以规避这个问题。

修改后的实体类字段：

private Integer port;

4. 手动生成随机端口（备选方案） #

如果以上方法都无效，可以在配置类中手动生成随机端口并赋值给SftpConfiguration：

@Bean
public SftpConfiguration sftpFileRetrievalConfiguration() {
  SftpConfiguration config = new SftpConfiguration();
  // 生成1024-65535之间的随机端口
  Random random = new Random();
  config.setPort(random.nextInt(65535 - 1024 + 1) + 1024);
  // 其他属性仍可通过@ConfigurationProperties绑定
  return config;
}

这种方式绕开配置文件的表达式解析，直接在代码中生成随机值，适合场景简单的需求。

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