Spring Boot 以“开箱即用”著称但恰恰是这个“开箱即用”让无数开发者在生产环境栽了跟头。默认配置跑得通本地不等于跑得稳生产。下面梳理几个最常踩的配置坑以及对应的排查思路。误区一迷信默认配置上线就炸这是最普遍、后果最严重的误区。Spring Boot 给了你一套“能用”的默认值但绝不是“够用”的生产值。Tomcat 线程池默认最大线程数只有 200。峰值 QPS 3000 时200 个线程处理 3000 QPS 意味着排队超过 2 秒直接超时。HikariCP 连接池默认最大连接数只有 10 个。QPS 超过 100 就开始等待连接。排查思路上线前必须过一遍生产级配置清单——Tomcat 线程数建议按“峰值 QPS × 平均 RT × 1.5”公式估算至少配到 500HikariCP 连接池单实例建议不超过 30Actuator 端点最小暴露禁用/env、/heapdump等敏感端点生产环境强制激活prodprofile。误区二配置文件“写”了但根本没生效你明明在application.yml里配了数据库连接启动时却报Failed to configure a DataSource: url attribute is not specified。配置根本没被读到。常见原因路径不对配置文件不在src/main/resources目录下命名不对文件名拼写错误比如applicaton.yml少了个iProfile 未激活用了application-dev.yml却没激活devprofile排查思路用Value(${spring.application.name:unknown})打印配置值如果输出unknown说明配置没加载。启动日志里看active profiles列表确认当前激活了哪个环境。误区三两种配置文件混用被覆盖了还不知道.properties和.yml同时存在时Spring Boot 的加载顺序会导致一个覆盖另一个。有开发者把端口配在application.yml里写8081.properties里写8080启动后发现访问的是8080。排查思路统一用一种格式推荐.yml。如果必须混用记住.properties优先级高于.yml。排查时可以用 Actuator 的/env端点查看某个配置项的最终值来自哪个来源。误区四YAML 缩进错了解析直接失败YAML 对缩进极其敏感。server: port: 8080少了一个空格整个配置段解析失败。排查思路启动日志里看到Config parsing failed或YAMLException十有八九是缩进问题。统一用两个空格缩进别用 Tab。误区五Profile 命名不规范环境切不过去把文件命名为application.Dev.yml或app-dev.ymlSpring 根本认不出来。排查思路严格遵循命名规范——application-{profile}.ymlprofile 必须全小写、短横线分隔。激活方式用--spring.profiles.activeprod命令行参数最可靠。误区六ConfigurationProperties 绑定失败写了配置类、配了前缀属性就是绑不上。常见原因没加Component或EnableConfigurationProperties配置类不在组件扫描路径下缺少 setter 方法属性名与配置 key 不一致YAML 中嵌套对象未正确缩进。排查思路设置ignoreUnknownFieldsfalse快速定位不匹配的属性启动时观察是否有ConfigurationPropertiesBindException异常。误区七日志配置了但就是不输出你配了日志级别控制台就是没日志。常见原因多个日志框架冲突log4j 和 logback 同时存在日志级别设置太高比如设成ERROR而业务日志是INFOlogback-spring.xml配置了但路径不对。排查思路用mvn dependency:tree检查是否有 log4j 依赖冲突确认logging.level.root至少是INFO用-Dlogging.configclasspath:logback-spring.xml强制指定配置文件。写在最后配置问题的排查核心就三句话第一看日志——启动日志里藏着 90% 的线索active profiles列表、配置加载路径、异常堆栈都在那里。第二查优先级——Spring Boot 支持十几种配置来源优先级从高到低依次是命令行参数 环境变量 外部配置文件 内部配置文件 默认值。配置不生效先确认有没有被更高优先级的来源覆盖了。第三用对工具——Actuator 的/env端点可以查看每个配置项的最终值及来源IDEA 的 Spring Boot 插件会高亮配置文件中无效或已废弃的配置 key。“开箱即用”是 Spring Boot 给开发者的礼物但“上线即用”从来不是默认配置能做到的。别等线上 502 了才想起来改配置——那时候改的每一行配置都带着血的教训。