如果你在使用 Spring Boot 的时候遇到了问题，我们很乐意为你提供帮助。 请访问 IX. How-to指南 中的内容 — 在这个指南中为常见的多数问题提供了解决方案。 学习更多有关 Spring 的基础知识。Spring Boot 是在很多其他的 Spring 项目上构建的。请访问 spring.io 网站来获得更多其他的参考文档。如果你现在才刚刚开始学习 Spring，请参考下面这个指南中的内容。 如果你希望询问一些问题。Spring 的官方会时时关注 stackoverflow.com 上有关使用 spring-boot 标签的问题。 如果你发现 Spring Boot 有使用上的 bug，请访问 github.com/spring-projects/spring-boot/issues 页面对你找的问题进行提交。 中文文档和手册 如果你对我们的文档有任何建议或者意见，请访问 https://www.cwiki.us/display/SpringBootZH 页面中的内容，我们的文档先会在这里进行修订后转换成 Git 电子书的模式。 Git 电子书仓库，我们的 Git 电子书是存储在 GitHub 上的，请单击 https://github.com/cwiki-us-spring-guides/Spring-Boot-Reference-Guide 链接进行访问。 https://www.cwiki.us/display/SpringBootZH/Getting+Help

如果你现在正在从早期的 Spring Boot 版本进行升级的话，请访问 “migration guide” on the project wiki 页面，这个页面提供了有关升级的详细指南。同时也请查看下 “release notes” 页面，在这个页面中提供了每次新版本发布的新的和值得关注的（new and noteworthy）的特性。 当一个新的版本发布的时候，一些属性可能会被重命名或者删除。Spring Boot 同时也提供了一个供你分析你应用程序环境和在启动的时候打印诊断信息的方法，同时还尝试帮助你在运行的时候为你整合属性。 如果你希望启用这个特性，请在你的项目中添加下面的依赖： <dependency>     <groupId>org.springframework.boot</groupId>     <artifactId>spring-boot-properties-migrator</artifactId>     <scope>runtime</scope> </dependency> 在后面添加进环境中的属性，将不会显示出来。例如 @PropertySource 当你完成整合后，请将这个模块从你的应用程序项目中删除。 为了更新已经存在的 CLI 安装，使用正确的包管理命令（例如，brew upgrad），如果你是手动安装的 CLI，请参考 standard instructions 页面中的内容。 请不要忘记更新你的 PATH 环境变量，来删除可能有指向到老的安装环境上的配置。   https://www.cwiki.us/display/SpringBootZH/Installing+Spring+Boot

Spring Boot CLI（Command Line Interface）是一个命令行工具，可用于快速搭建基于Spring的原型。它支持运行Groovy 脚本，这也就意味着你可以使用类似Java的语法，但不用写很多的模板代码。 Spring Boot 不一定非要配合 CLI 使用，但它绝对是让 Spring 应用进入状态的最快方式。 手动安装 你可以从 Spring 的软件仓库中下载 Spring CLI 分发包： spring-boot-cli-2.1.0.RELEASE-bin.zip spring-boot-cli-2.1.0.RELEASE-bin.tar.gz 更前沿和更新的 snapshot distributions 也是可以下载到的。 一旦你下载完成后，请按照 INSTALL.txt 中的指南来解压归档文件。主要来说，这里有一个 spring 脚本（spring.bat 是针对 Windows 使用的）在 bin/ 目录下的 .zip 文件中。可选的，你可以使用 java -jar 再加上 .jar 文件（脚本文件能够帮助你确保 classpath 已经正确的设置了）。 使用 SDKMAN! 进行安装 SDKMAN! (The Software Development Kit Manager) 中文可以翻译为软件开发管理工具可以被用来管理多个版本的 2 进制 SDKs，包括  Groovy 和Spring Boot CLI。你可以从 sdkman.io 网站上来获得 SDKMAN!，然后通过使用下面的命令行工具来安装 Spring Boot： $ sdk install springboot $ spring --version Spring Boot v2.1.0.RELEASE 如果你正在为CLI开发新的特性，并想轻松获取刚构建的版本，可以使用以下命令： $ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.0.RELEASE-bin/spring-2.1.0.RELEASE/ $ sdk default springboot dev $ spring --version Spring CLI v2.1.0.RELEASE 前面的安装指南将会安装一个被称为 dev  的 spring  安装实例。 它指向你的目标构建位置，所以每次你重构 Spring Boot，spring 都会更新为最新的。 你可以通过下面的命令来查看到： $ sdk ls springboot ================================================================================ Available Springboot Versions ================================================================================ > + dev * 2.1.0.RELEASE ================================================================================ + - local version * - installed > - currently in use ================================================================================ OSX Homebrew 安装 如果你使用的是 Mac 同时使用 Homebrew，你可以通过使用下面的 Spring Boot CLI 来进行安装： $ brew tap pivotal/tap $ brew install springboot Homebrew 将会把 spring 安装到 /usr/local/bin 目录下 如果上面的命令不能安装到你的机器上，那么有可能是因为你的 brew 版本太老了。你只需执行 brew update 并重试即可。 MacPorts 安装 如果你使用的是 Mac 同时使用 MacPorts，你可以通过使用下面的 Spring Boot CLI 来进行安装： $ sudo port install spring-boot-cli 命令行实现 SpringBoot CLI 包含的脚本为 BASH 和 zsh shell 提供了实现。你可以在任何 shell，你的个人或系统的 bash 中 source 脚本（同时也命名为 spring）来完成初始化。在 Debian 系统中，全系统脚本在 /shell-completion/bash 或者当新的shell启动时该目录下的所有脚本都会被执行。例如，如果想要手动运行脚本，假如你已经安装了SDKMAN，可以使用以下命令： $ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring $ spring <HIT TAB HERE> grab help jar run test version 如果你是通过使用 Homebrew 或 MacPorts 安装 Spring Boot CLI 的话，命令行工具将会自动在你的 shell 中注册。 Windows Scoop 安装 如果你使用的是 Windows 同时使用e Scoop，你可以通过使用下面的 Spring Boot CLI 来进行安装： > scoop bucket add extras > scoop install springboot Scoop 将会把脚本安装到  ~/scoop/apps/springboot/current/bin。 如果你没看到 app 的 manifest，那么有可能是你的额 scoop 安装已经过时了，请运行 scoop update 命令后再次尝试。 快速启动 Spring CLI 示例 你可以使用下面的 Web 应用来测试你的安装。为了启动，创建一个文件为 app.groovy，然后将下面的内容保存到这个文件中： @RestController class ThisWillActuallyRun { @RequestMapping("/") String home() { "Hello World!" } } 然后从 shell 中运行，使用下面的命令： $ spring run app.groovy 第一次运行的时候可能会比较慢，因为程序需要下载需要的依赖，在后续的运行中就会更加快速了。 在你的浏览器中输访问下面的 URL localhost:8080，你应该能够看到在浏览器中显示下面的内容： Hello World! https://www.cwiki.us/display/SpringBootZH/Installing+Spring+Boot

Spring Boot 可以使用经典的开发工具或者使用安装的命令行工具。不管使用何种方式，你都需要确定你的 Java 版本为 Java SDK v1.8 或者更高的版本。在你开始安装之前，你需要确定你当前安装的 Java 版本满足系统运行的需要。 你可以使用下面的命令进行查看： $ java -version 如果你是 Java 项目开发的新手或者你希望实践使用 Spring Boot。你应该使用 Spring Boot 命令行工具（Spring Boot CLI），否则的话，请阅读有关经典安装指南。 针对 Java 开发人员的安装指南 对于Java 开发者来说，使用 Spring Boot 就跟使用其他 Java 库一样，只需要在你的 classpath 下引入适当的 spring-boot-*.jar 文件。 Spring Boot不需要集成任何特殊的工具，所以你可以使用任何IDE或文本编辑器；同时，Spring Boot应用也没有什么特殊之处，你可以像对待其他Java程序那样运行，调试它。 尽管可以拷贝 Spring Boot jars，但我们还是更加建议你使用支持依赖管理的构建工具，比如 Maven 或 Gradle。 Maven 安装 Spring Boot 兼容 Apache Maven 3.3 或更高版本。如果本地没有安装Maven，你可以参考 maven.apache.org 上的指南在你本地安装 Maven。 在很多操作系统中，Maven 可以通过包管理器进行安装。如果你使用 OSX Homebrew 操作系统，你可以考虑使用 brwe 安装 Maven。 在 Ubuntu 中，你可以运行 sudo apt-get install 命令来安装 Maven。 Windows 用户，如果你使用了 Chocolatey ，你可以从弹出的管理员控制台中运行 choco install maven 命令。 Spring Boot依赖使用的 groupId 为 org.springframework.boot。 通常，你的 Maven POM 文件会继承 spring-boot-starter-parent 工程，并声明一个或多个 Starters 依赖。此外，Spring Boot提供了一个可选的  Maven 插件，用于创建可执行的 jars。 下面的 XML 文件中显示了一个常用的 pom.xml 文件。 <?xml version="1.0" encoding="UTF-8"?> <project     xmlns="http://maven.apache.org/POM/4.0.0"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">     <modelVersion>4.0.0</modelVersion>     <groupId>com.example</groupId>     <artifactId>myproject</artifactId>     <version>0.0.1-SNAPSHOT</version>     <!-- Inherit defaults from Spring Boot -->     <parent>         <groupId>org.springframework.boot</groupId>         <artifactId>spring-boot-starter-parent</artifactId>         <version>2.1.0.RELEASE</version>     </parent>     <!-- Add typical dependencies for a web application -->     <dependencies>         <dependency>             <groupId>org.springframework.boot</groupId>             <artifactId>spring-boot-starter-web</artifactId>         </dependency>     </dependencies>     <!-- Package as an executable jar -->     <build>         <plugins>             <plugin>                 <groupId>org.springframework.boot</groupId>                 <artifactId>spring-boot-maven-plugin</artifactId>             </plugin>         </plugins>     </build> </project> 通常来说 spring-boot-starter-parent 是使用 Spring Boot 的一种不错的方式，但它可能并不总是最合适的。有时你可能需要继承一个不同的父 POM，或者不喜欢我们的默认配置。 在这种情况下，你可以使用 import 作用域（import scope）来替代默认的父 POM 继承，具体请查看：这种替代方案，具体查看 Section 13.2.2, “Using Spring Boot without the Parent POM” 页面中的内容。 Gradle 安装 Spring Boot 现在能够兼容 Gradle 4.4 及其后续版本。如果你的系统中还没有安装 Gradle， 你可以参考 gradle.org 页面中的内容。 Spring Boot 的依赖可通过 groupId 为 org.springframework.boot 来进行声明。通常，你的项目将声明一个或多个 “Starters” 依赖。Spring Boot 同时还提供了一个有用的 Gradle plugin 插件。这个插件通常可以用来简化依赖声明和创建可以执行的 jars。 Gradle Wrapper 当你需要构建项目时，Gradle Wrapper提供一种有效的获取 Gradle 的方式。它是一小段脚本和库，跟你的代码一块提交，用于启动构建进程，具体参考页面 docs.gradle.org/4.2.1/userguide/gradle_wrapper.html 中的内容。 更多有关开始使用 Spring Boot 和 Gradle 的细节可以在 Getting Started section 页面中的 Gradle 插件参考指南中找到。   https://www.cwiki.us/display/SpringBootZH/Installing+Spring+Boot

错误信息如下： Caused by: com.opensymphony.xwork2.config.ConfigurationException: Bean type class com.opensymphony.xwork2.ObjectFactory with the name struts has already been loaded by bean - jar:file:/C:/Users/YuCheng/Documents/WorkDir/Ossez/cwiki-us/src/spring-boot-sample-struts2/target/spring-boot-sample-struts2-1.0.0-SNAPSHOT.war!/WEB-INF/lib/struts2-core-2.5.16.jar!/struts-default.xml:73:72 at com.opensymphony.xwork2.config.providers.XmlConfigurationProvider.register(XmlConfigurationProvider.java:260) ~[struts2-core-2.5.16.jar!/:2.5.16] ... 19 common frames omitted 这个有可能是 <dependency> <groupId>org.apache.struts</groupId> <artifactId>struts2-spring-plugin</artifactId> <version>2.5.16</version> </dependency> 和 Spring Boot 的环境有冲突。 你可以在上面的引用中添加一个 <scope>provided</scope> 然后修改为： <dependency> <groupId>org.apache.struts</groupId> <artifactId>struts2-spring-plugin</artifactId> <version>2.5.16</version> <scope>provided</scope> </dependency> https://www.cwiki.us/questions/41681342

Spring Boot 2.1.0.RELEASE 方需要 Java 8 or 9 的支持和 Spring Framework 5.1.2.RELEASE 以上的版本。 明确的构建工具的支持，请参考下面的构建工具： 构建工具 版本 Maven 3.3+ Gradle 4.4+ Servlet 容器 Spring Boot 支持下面的嵌入 servlet 容器： 名字 Servlet 版本 Tomcat 9.0 4.0 Jetty 9.4 3.1 Undertow 2.0 4.0 你也可以将 Spring Boot 部署到任何支持  Servlet 3.1+ 的容器中。   https://www.cwiki.us/display/SpringBootZH/System+Requirements