很多新手跑通第一个接口就以为掌握了SpringBoot结果上线后才发现坑一个比一个深。框架帮你做了太多默认决策你不问为什么它就默认你懂。可这些默认值恰恰是生产事故的源头。启动类的位置决定了包扫描的边界SpringBootApplication默认只扫描启动类所在包及其子包。有人把启动类放在com.example.demo.controller下结果service包在隔壁启动报找不到Bean。规则很简单启动类放在项目根包比如com.example所有业务代码都在它下面。别挑战这个约定挑战的代价是排查半天。配置文件占位符没有默认值就是定时炸弹spring.datasource.url: ${DB_URL}如果环境变量没设启动直接失败。正确写法是给冒号默认值${DB_URL:jdbc:mysql://localhost:3306/dev}。本地开发不配环境变量也能跑生产环境通过环境变量覆盖。没有默认值的占位符等于把启动权限交给了运维。测试类会启动整个容器别在里面连生产库SpringBootTest默认加载完整上下文包括数据源。如果测试环境没配好CI流水线一跑就崩。正确做法是用ActiveProfiles(test)指定测试配置或者用DataJpaTest、WebMvcTest做切片测试。测试慢不可怕测试连错库才可怕。devtools热部署生产环境必须移除开发时改代码自动重启很爽。但spring-boot-devtools默认启用重启类加载器打包进生产Jar会导致内存泄漏和类加载冲突。正确做法是把依赖设为optionaltrue/optional并用excludeDevtools在打包时排除。开发利器生产毒药别搞混了。静态资源路径默认只认四个地方/static、/public、/resources、/META-INF/resources这是SpringBoot默认的静态资源目录。你把HTML放在src/main/webapp访问404然后怀疑人生。要么放到默认目录要么在application.yml里配spring.web.resources.static-locations。约定大于配置不是没有配置。日志配置别只依赖默认输出SpringBoot默认用Logback只输出到控制台级别INFO。生产环境需要文件日志、滚动策略、异步输出。在application.yml里配logging.file.name和logging.level.root或者写logback-spring.xml。没有文件日志出了问题连现场都没了。日志是事后追责的唯一证据。Actuator端点暴露越多风险越大/actuator/env能看环境变量/actuator/heapdump能下载堆快照。默认只暴露/health和/info有人图方便设成等于把后门敞开。生产环境只开必要端点配合Spring Security做认证。便利和安全永远选安全。这七个细节每一个都有人踩过坑。SpringBoot的哲学是“默认合理随时可改”但前提是你知道默认是什么。知其然更要知其所以然。别等生产报警了才翻文档那时候代价已经付了。