@PropertySource无法读取指定外部配置文件，取值异常求助

问题根源拆解 #

1. 配置Key不匹配：你在secret.id.properties里定义的是spring.cloud.gcp.bigquery.project-id=project-id，但代码里尝试读取的是secret.id，两者完全不一致，这是直接导致取不到值的核心原因。
2. 外部配置优先级与加载顺序：即使路径正确，若application.properties中的配置优先级更高，也会覆盖外部配置；另外@PropertySource默认加载顺序是先声明的优先级低，后声明的会覆盖先声明的，但还要结合Spring默认的配置加载顺序判断。

修复步骤 #

步骤1：修正配置文件与代码的Key匹配 #

方案A：修改配置文件Key

调整/Users/myUser/etc/secrets/secret.id.properties的内容，将Key改为代码中要读取的secret.id：

secret.id=project-id

方案B：修改代码读取的Key

如果想保留配置文件中的spring.cloud.gcp.bigquery.project-id，就把代码里的读取逻辑改成对应Key：

@Value("${spring.cloud.gcp.bigquery.project-id}")
private String projectID;

public String getId() {
    return env.getProperty("spring.cloud.gcp.bigquery.project-id");
}

步骤2：确保外部配置优先级高于application.properties #

Spring Boot中外部文件路径的配置默认比classpath:下的application.properties优先级高，可通过以下方式强化：

• 调整@PropertySource属性：添加编码配置确保读取正常，同时确认ignoreResourceNotFound=true是你需要的（文件不存在时不报错）：

@PropertySources({
        @PropertySource(value = "file:/Users/myUser/etc/secrets/credentials.json",
                ignoreResourceNotFound = true, encoding = "UTF-8"),
        @PropertySource(value = "file:/Users/myUser/etc/secrets/secret.id.properties",
                ignoreResourceNotFound = true, encoding = "UTF-8")})

• 使用启动参数指定配置路径：启动程序时通过参数强制让外部配置优先级最高，比如：

java -jar your-app.jar --spring.config.location=file:/Users/myUser/etc/secrets/,classpath:/

该命令会先加载/Users/myUser/etc/secrets/下的所有配置文件，再加载classpath下的application.properties，外部配置会自动覆盖内部配置。

步骤3：修复application.properties中的错误配置 #

你之前尝试的两种配置均存在问题：

• spring.cloud.gcp.bigquery.project-id=${secret.id}：若secret.id未被正确加载，会因占位符无法解析报错，需确保secret.id能正常读取后再使用。
• spring.cloud.gcp.bigquery.project-id=${spring.cloud.gcp.bigquery.project-id}：属于循环引用，必然报错，直接删除该配置。

步骤4：验证配置加载Bean #

你的配置类中已经声明了static的PropertySourcesPlaceholderConfigurer Bean，这是正确的——静态Bean能保证在其他Bean初始化前加载配置。如果是Spring Boot项目，其实无需手动声明该Bean，框架会自动配置，但手动声明也不影响功能。

额外排查点 #

• 检查文件权限：确保运行程序的用户拥有/Users/myUser/etc/secrets/目录及文件的读取权限，避免因权限问题导致无法读取。
• 开启配置日志：在application.properties中添加logging.level.org.springframework.context=DEBUG，启动后查看日志，确认配置文件是否被成功加载，以及加载顺序、Key的取值情况。

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