spring_reference/IX. ‘How-to’ guides/62.1. Troubleshoot auto-con...

16 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

### 62.1. 解决自动配置问题
Spring Boot自动配置总是尝试尽最大努力去做正确的事但有时候会失败并且很难说出失败原因。
在每个Spring Boot `ApplicationContext`中都存在一个相当有用的`ConditionEvaluationReport`。如果开启`DEBUG`日志输出,你将会看到它。如果你使用`spring-boot-actuator`,则会有一个`autoconfig`的端点它将以JSON形式渲染该报告。可以使用它调试应用程序并能查看Spring Boot运行时都添加了哪些特性及哪些没添加
通过查看源码和javadoc可以获取更多问题的答案。以下是一些经验
* 查找名为`*AutoConfiguration`的类并阅读源码,特别是`@Conditional*`注解,这可以帮你找出它们启用哪些特性及何时启用。
将`--debug`添加到命令行或添加系统属性`-Ddebug`可以在控制台查看日志该日志会记录你的应用中所有自动配置的决策。在一个运行的Actuator app中通过查看`autoconfig`端点(`/autoconfig`或等效的JMX可以获取相同信息。
* 查找是`@ConfigurationProperties`的类(比如[ServerProperties](http://github.com/spring-projects/spring-boot/tree/master/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/web/ServerProperties.java))并看下有哪些可用的外部配置选项。`@ConfigurationProperties`类有一个用于充当外部配置前缀的`name`属性,因此`ServerProperties`的值为`prefix="server"`,它的配置属性有`server.port``server.address`等。在运行的Actuator应用中可以查看`configprops`端点。
* 查看使用`RelaxedEnvironment`明确地将配置从`Environment`暴露出去。它经常会使用一个前缀。
* 查看`@Value`注解,它直接绑定到`Environment`。相比`RelaxedEnvironment`这种方式稍微缺乏灵活性但它也允许松散的绑定特别是OS环境变量所以`CAPITALS_AND_UNDERSCORES`是`period.separated`的同义词)。
* 查看`@ConditionalOnExpression`注解它根据SpEL表达式的结果来开启或关闭特性通常使用解析自`Environment`的占位符进行计算。