@conditionalonresource注解需精准识别资源路径：推荐用classpath:开头的相对路径（如classpath:config.yml），禁用反斜杠、前导斜杠或点号；绝对路径仅限调试，且需确保文件真实存在；常见错误包括路径格式错误、扩展名缺失及资源未编译进classes目录。
在Spring Boot中使用@ConditionalOnResource注解时，必须让Spring能准确识别资源是否存在，路径写错会导致条件判断永远不生效或抛出异常。
相对路径写法（推荐）
直接写类路径下的相对路径，以classpath:开头，斜杠用正斜杠/，不加前导斜杠。
在application.properties同级目录放config.yml → 写成 【classpath:config.yml】
在resources/static/js下放main.js → 写成 【classpath:static/js/main.js】
注意：不能写成 classpath:/static/js/main.js 或 classpath:./static/js/main.js，Spring会找不到。
绝对路径写法（慎用）
方法一：用file:协议指向文件系统绝对路径
写成 file:/opt/app/config.properties
这一步操作起来很简单，但仅限开发环境调试，打包后部署到其他服务器时路径必然失效。
方法二：用系统属性动态拼接
@ConditionalOnResource(resources = "file:${user.home}/.myapp/settings.json")
注意：${user.home}必须真实存在该文件，否则条件不满足；Spring不会自动创建父目录。
常见错误路径写法
第一步：检查是否误用了Windows风格反斜杠 → 错误示例：classpath:conf\app.cfg
第二步：确认是否漏掉了扩展名 → 错误示例：classpath:application（实际是application.yml）
第三步：验证路径是否在编译后仍存在于target/classes或jar包内 → 若文件放在src/main/java下，Maven默认不复制到classes目录，【@ConditionalOnResource对此类路径始终判定为不存在】
