SpringBoot 自动配置基于约定优于配置原则，通过@EnableAutoConfiguration 注解和条件注解实现 Bean 的自动注册。本文深入源码分析自动配置加载流程，包括候选类筛选、条件匹配及属性绑定机制。结合自定义 Starter 实战案例，演示核心功能模块与自动配置模块的开发步骤，涵盖 LogService 的自动装配与配置覆盖。此外，提供调试技巧如开启 debug 日志和使用 Actuator 端点，以及优化策略如排除无用配置和延迟初始化，帮助开发者掌握自动配置原理并解决常见冲突问题。
在 Java 开发领域，SpringBoot 的出现彻底改变了传统 Spring 应用繁琐的配置模式，其核心优势'约定优于配置'背后，正是自动配置（Auto-Configuration）机制在发挥作用。很多开发者在使用 SpringBoot 时，往往惊叹于'引入依赖就能用'的便捷，却对其底层实现一知半解。本文将从自动配置的核心概念出发，逐层拆解其实现原理，结合源码分析与实战案例，帮助读者从'会用'到'懂原理'，最终能够灵活定制符合自身业务需求的自动配置方案。
在 SpringBoot 诞生之前，开发一个 Spring 应用需要经历一系列繁琐的配置工作。例如，要开发一个简单的 Web 应用，开发者需要手动完成以下操作：
这种配置方式不仅效率低下，而且容易出现配置错误，不同开发者的配置风格差异也会导致项目维护成本增加。当项目规模扩大时，配置文件的复杂度会呈指数级增长，成为开发过程中的'负担'。
SpringBoot 的自动配置机制正是为解决传统 Spring 配置痛点而生，其核心价值体现在'约定优于配置'（Convention Over Configuration）的设计思想上。简单来说，SpringBoot 会根据开发者引入的依赖、当前的环境配置，自动推断并配置项目运行所需的核心 Bean，从而实现'零配置启动应用'。
例如，当开发者在 pom.xml 中引入 spring-boot-starter-web 依赖后，SpringBoot 会自动完成以下配置：
这种'引入依赖即配置'的模式，不仅极大提升了开发效率，还保证了配置的规范性和一致性，降低了团队协作成本。
SpringBoot 的自动配置并非'一刀切'的强制配置，而是具备高度灵活性和可定制性的机制，其核心特性包括：
要真正理解 SpringBoot 自动配置，就必须深入其源码层面，搞清楚'自动配置是如何触发的''SpringBoot 如何推断配置需求''配置优先级如何实现'等核心问题。本节将以 SpringBoot 2.7.x 版本为例，从核心注解、加载流程、条件注解三个维度拆解其实现原理。
任何 SpringBoot 应用的启动类都标注了@SpringBootApplication 注解，这个注解正是自动配置的'入口'。从源码来看，@SpringBootApplication 是一个复合注解，其核心组成部分包括：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
public @interface SpringBootApplication {
// 本质是@Configuration，标记当前类为配置类
@EnableAutoConfiguration
// 开启自动配置的核心注解
@ComponentScan(excludeFilters = {
@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class)
})
// 省略属性...
}
在这些注解中，@EnableAutoConfiguration是开启自动配置的核心，正是这个注解触发了后续一系列的自动配置流程。
@EnableAutoConfiguration 注解的核心作用是'启用 SpringBoot 的自动配置机制'，其源码如下：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
Class<?>[] exclude() default {};
String[] excludeName() default {};
}
这个注解包含两个关键部分，分别负责'确定扫描范围'和'加载自动配置类'：
@AutoConfigurationPackage 注解的作用是'将启动类所在的包及其子包作为自动扫描的范围'，这也是为什么 SpringBoot 的组件（@Controller、@Service、@Repository 等）不需要手动配置扫描路径就能被 Spring 容器识别的原因。
从源码来看，该注解通过@Import(AutoConfigurationPackages.Registrar.class)导入一个注册器，该注册器会将启动类的包路径注册到 Spring 容器中，作为后续组件扫描的基础范围。
AutoConfigurationImportSelector 是自动配置的'核心引擎'，其核心作用是'从类路径中筛选出符合条件的自动配置类，并将其导入到 Spring 容器中'。整个流程可以分为三个关键步骤：
AutoConfigurationImportSelector 会通过 SpringFactoriesLoader.loadFactoryNames() 方法，从类路径下的 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件中，加载所有候选的自动配置类全限定名。
在 spring-boot-autoconfigure 依赖中，这个文件包含了数百个自动配置类的配置，例如：
org.springframework.boot.autoconfigure.web.servlet.DispatcherServletAutoConfiguration
org.springframework.boot.autoconfigure.web.servlet.ServletWebServerFactoryAutoConfiguration
org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
org.springframework.boot.autoconfigure.mybatis.MybatisAutoConfiguration
// 省略其他自动配置类...
这些类就是 SpringBoot 预定义的自动配置模板，涵盖了 Web 开发、数据访问、安全等各个场景。
加载候选自动配置类后，AutoConfigurationImportSelector 会结合@EnableAutoConfiguration 注解的 exclude 属性、当前环境配置以及条件注解（如@Conditional），对候选类进行筛选，只保留'符合当前环境和需求'的自动配置类。
例如，如果开发者没有引入数据库相关依赖，那么 DataSourceAutoConfiguration 等数据访问相关的自动配置类会被筛选掉，不会被导入到 Spring 容器中。
筛选完成后，AutoConfigurationImportSelector 会将最终的自动配置类列表返回给 Spring 容器，Spring 会按照正常的配置类加载流程，解析这些类中的 Bean 定义，并将其注册到容器中，完成自动配置。
条件注解是 SpringBoot 自动配置'精准触发'的核心，它允许自动配置类仅在满足特定条件时才生效。SpringBoot 提供了一系列基于@Conditional 的派生注解，覆盖了依赖存在性、Bean 存在性、环境变量等多种场景，常用的条件注解如下表所示：
| 注解 | 核心作用 | 使用场景示例 |
|---|---|---|
| @ConditionalOnClass | 当类路径中存在指定类时生效 | WebMvcAutoConfiguration 依赖 Servlet 类，仅在 Web 环境生效 |
| @ConditionalOnMissingClass | 当类路径中不存在指定类时生效 | 自定义配置类替代默认配置时使用 |
| @ConditionalOnBean | 当 Spring 容器中存在指定 Bean 时生效 | DataSourceTransactionManager 依赖 DataSource Bean |
| @ConditionalOnMissingBean | 当 Spring 容器中不存在指定 Bean 时生效 | 自动配置类的默认 Bean，允许开发者手动覆盖 |
| @ConditionalOnProperty | 当指定配置属性存在且符合预期值时生效 | 通过 spring.datasource.enabled 控制数据源配置是否生效 |
| @ConditionalOnWebApplication | 当应用是 Web 应用时生效 | DispatcherServletAutoConfiguration 仅在 Web 环境生效 |
以 ServletWebServerFactoryAutoConfiguration（Web 容器自动配置类）为例，其源码中就大量使用了条件注解：
@Configuration(proxyBeanMethods = false)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
@ConditionalOnClass(ServletRequest.class)
@ConditionalOnWebApplication(type = Type.SERVLET)
@EnableConfigurationProperties(ServerProperties.class)
public class ServletWebServerFactoryAutoConfiguration {
// 自动配置 Tomcat 的 Bean
@Configuration(proxyBeanMethods = false)
@ConditionalOnClass({Tomcat.class, UpgradeProtocol.class})
@ConditionalOnMissingBean(value = ServletWebServerFactory.class, search = SearchStrategy.CURRENT)
public static class TomcatServletWebServerFactoryConfiguration {
@Bean
public TomcatServletWebServerFactory tomcatServletWebServerFactory(ServerProperties serverProperties) {
TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
factory.setPort(serverProperties.getPort());
factory.setContextPath(serverProperties.getServlet().getContextPath());
return factory;
}
}
// 省略 Jetty、Undertow 相关配置...
}
从上述源码可以看出，只有当应用是 Servlet 类型的 Web 应用，且类路径中存在 Tomcat 相关类，同时容器中没有手动配置 ServletWebServerFactory 时，SpringBoot 才会自动配置 Tomcat 作为内置 Web 容器。这种多条件组合的方式，确保了自动配置的精准性。
自动配置并非'黑盒'，开发者可以通过配置文件（如 application.yml、application.properties）灵活调整自动配置的行为，这一功能的核心是@ConfigurationProperties 注解，它实现了'配置文件属性与 Java 类的绑定'。
以 ServerProperties 为例，SpringBoot 通过该类封装了 Web 服务器的相关配置属性：
@ConfigurationProperties(prefix = "server", ignoreUnknownFields = true)
public class ServerProperties {
private Integer port;
private String servletPath = "";
private Duration connectionTimeout;
// 省略 getter、setter 方法...
}
该类通过@ConfigurationProperties(prefix = 'server')指定了属性前缀，开发者只需在 application.yml 中以'server'为前缀配置相关属性，即可覆盖默认值：
server:
port: 8081
servlet:
context-path: /demo
connection-timeout: 30s
在自动配置类中，通过@EnableConfigurationProperties(ServerProperties.class)导入该类后，就可以直接使用这些配置属性来定制 Bean 的行为，实现'配置驱动'的自动配置。
理解了自动配置的原理后，我们可以通过自定义自动配置类，实现'引入依赖即自动配置自定义组件'的效果。本节将以'自定义一个日志组件 starter'为例，完整演示自定义自动配置的开发流程，包括项目结构设计、自动配置类编写、starter 打包发布等环节。
开发一个名为'demo-log-starter'的 starter，具备以下功能：
自定义 starter 通常包含两个模块：核心功能模块（提供业务逻辑）和自动配置模块（实现自动配置逻辑），项目结构如下：
demo-log-starter/
├── demo-log-core/ # 核心功能模块
│ └── src/main/java/com/demo/log/LogService.java
└── demo-log-autoconfigure/ # 自动配置模块
├── src/main/java/com/demo/log/autoconfigure/
│ ├── LogAutoConfiguration.java
│ └── LogProperties.java
└── src/main/resources/
└── META-INF/
└── spring/
└── org.springframework.boot.autoconfigure.AutoConfiguration.imports
这种模块化拆分的优势在于：核心功能模块与 SpringBoot 解耦，可单独使用；自动配置模块专注于配置逻辑，职责清晰。
核心功能模块提供日志服务的核心逻辑，不依赖 SpringBoot 相关 API，确保模块的通用性。
LogService 是核心业务类，提供 info、error 两种日志记录方法，支持自定义日志前缀：
package com.demo.log;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class LogService {
private String prefix;
public LogService(String prefix) {
this.prefix = prefix;
}
public void info(String message) {
String log = buildLog("INFO", message);
System.out.println(log);
}
public void error(String message, Throwable throwable) {
String log = buildLog("ERROR", message);
System.err.println(log);
throwable.printStackTrace();
}
private String buildLog(String level, String message) {
String time = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
return String.format("[%s] [%s] %s %s", time, level, prefix, message);
}
}
核心模块仅需引入 JDK 相关依赖，pom.xml 配置如下：
<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>
<parent>
<groupId>com.demo</groupId>
<artifactId>demo-log-starter</artifactId>
<version>1.0.0</version>
</parent>
<artifactId>demo-log-core</artifactId>
<name>demo-log-core</name>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
</project>
自动配置模块是实现'自动配置'的核心，负责编写配置属性类、自动配置类，并注册自动配置类。
LogProperties 用于绑定配置文件中的属性，支持开发者自定义日志前缀和是否启用自动配置：
package com.demo.log.autoconfigure;
import org.springframework.boot.context.properties.ConfigurationProperties;
@ConfigurationProperties(prefix = "demo.log")
public class LogProperties {
private boolean enabled = true;
private String prefix = "[DEMO-LOG]";
// 省略 getter、setter 方法
}
LogAutoConfiguration 是自动配置的核心类，结合条件注解和配置属性，实现 LogService 的自动配置：
package com.demo.log.autoconfigure;
import com.demo.log.LogService;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
@EnableConfigurationProperties(LogProperties.class)
@ConditionalOnClass(LogService.class)
@ConditionalOnProperty(prefix = "demo.log", name = "enabled", matchIfMissing = true)
public class LogAutoConfiguration {
private final LogProperties logProperties;
public LogAutoConfiguration(LogProperties logProperties) {
this.logProperties = logProperties;
}
@Bean
@ConditionalOnMissingBean
public LogService logService() {
return new LogService(logProperties.getPrefix());
}
}
该类通过多个条件注解组合，确保 LogService Bean 仅在'启用配置''类路径存在核心类''无手动配置 Bean'三个条件同时满足时才会自动配置。
SpringBoot 2.7.x 版本后，自动配置类的注册方式从 META-INF/spring.factories 改为 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件。我们需要在该文件中添加自动配置类的全限定名，确保 SpringBoot 能够扫描到该类：
com.demo.log.autoconfigure.LogAutoConfiguration
自动配置模块需要依赖核心功能模块和 SpringBoot 自动配置相关依赖：
<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>
<parent>
<groupId>com.demo</groupId>
<artifactId>demo-log-starter</artifactId>
<version>1.0.0</version>
</parent>
<artifactId>demo-log-autoconfigure</artifactId>
<name>demo-log-autoconfigure</name>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>com.demo</groupId>
<artifactId>demo-log-core</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
<version>2.7.10</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<version>2.7.10</version>
<optional>true</optional>
</dependency>
</dependencies>
</project>
在父模块 demo-log-starter 的 pom.xml 中配置聚合模块后，执行以下 Maven 命令将 starter 安装到本地仓库（用于本地测试）：
mvn clean install
执行成功后，demo-log-starter 会被安装到本地 Maven 仓库中，其他项目可通过引入依赖使用该 starter。
创建一个 SpringBoot 测试项目，通过引入 demo-log-starter 依赖，验证自动配置效果。
在测试项目的 pom.xml 中引入自定义 starter：
<dependency>
<groupId>com.demo</groupId>
<artifactId>demo-log-autoconfigure</artifactId>
<version>1.0.0</version>
</dependency>
创建一个 Controller 类，注入自动配置的 LogService 并使用：
package com.demo.test;
import com.demo.log.LogService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class LogController {
@Autowired
private LogService logService;
@GetMapping("/log/info")
public String logInfo() {
logService.info("这是一条 info 日志");
return "日志记录成功";
}
@GetMapping("/log/error")
public String logError() {
try {
int i = 1 / 0;
} catch (Exception e) {
logService.error("这是一条 error 日志", e);
}
return "错误日志记录成功";
}
}
[2025-12-16 10:00:00] [INFO] [DEMO-LOG] 这是一条 info 日志
在 application.yml 中配置自定义前缀：
demo:
log:
prefix: "[CUSTOM-LOG]"
enabled: true
重启项目后再次访问接口，控制台输出：
[2025-12-16 10:05:00] [INFO] [CUSTOM-LOG] 这是一条 info 日志
在测试项目中手动配置一个 LogService Bean：
@Configuration
public class CustomLogConfig {
@Bean
public LogService logService() {
return new LogService("[MANUAL-LOG]");
}
}
重启项目后访问接口，控制台输出手动配置的日志前缀，说明自动配置已被覆盖：
[2025-12-16 10:10:00] [INFO] [MANUAL-LOG] 这是一条 info 日志
在实际开发中，我们可能会遇到'自动配置未生效''配置冲突'等问题，需要掌握自动配置的调试方法。同时，针对大规模应用，还需要对自动配置进行优化，提升应用启动效率。本节将介绍自动配置的调试技巧、常见问题解决方法以及优化策略。
SpringBoot 提供了专门的日志开关，用于打印自动配置的详细过程，包括'哪些自动配置类生效''哪些被排除'以及排除原因。开启方式有两种：
在应用启动时添加以下 JVM 参数：
-Ddebug=true
在 application.yml 中添加以下配置：
debug: true
开启后，启动日志中会包含'AutoConfigurationReport'部分，示例如下：
Positive matches:
-----------------
DispatcherServletAutoConfiguration matched:
- @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet' (OnClassCondition)
- @ConditionalOnWebApplication (required) found 'session' scope (OnWebApplicationCondition)
Negative matches:
-----------------
DataSourceAutoConfiguration matched:
- @ConditionalOnClass found required class 'javax.sql.DataSource' (OnClassCondition)
- @ConditionalOnMissingBean (types: javax.sql.DataSource; SearchStrategy: all) did not find any beans (OnBeanCondition)
- @ConditionalOnProperty (spring.datasource.enabled=true) matched (OnPropertyCondition) but failed:
- @ConditionalOnClass did not find required class 'com.zaxxer.hikari.HikariDataSource' (OnClassCondition)
其中'Positive matches'表示生效的自动配置类，'Negative matches'表示未生效的自动配置类及原因，通过这些信息可以快速定位配置问题。
SpringBoot Actuator 是监控应用的工具，通过其提供的/beans 端点，可以查看 Spring 容器中所有 Bean 的详细信息，包括 Bean 的名称、类型、创建来源（自动配置类或手动配置类）等。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
在 application.yml 中配置：
management:
endpoints:
web:
exposure:
include: beans
启动应用后，访问 http://localhost:8080/actuator/beans，会返回所有 Bean 的 JSON 信息，例如自动配置的 logService Bean：
{
"beans": [
{
"bean": "logService",
"aliases": [],
"scope": "singleton",
"type": "com.demo.log.LogService",
"resource": "class path resource [com/demo/log/autoconfigure/LogAutoConfiguration.class]",
"dependencies": []
}
]
}
通过'resource'字段可以明确 Bean 是由哪个自动配置类创建的，快速定位 Bean 的来源。
问题表现：引入依赖后，预期的 Bean 未被注册到 Spring 容器中。
排查与解决步骤：
问题表现：在配置文件中配置了属性，但自动配置类未获取到正确的属性值。
排查与解决步骤：
问题表现：手动配置 Bean 后，启动应用时出现'BeanDefinitionOverrideException'（Bean 定义覆盖异常）。
解决方法：
SpringBoot 的 autoconfigure 依赖中包含大量自动配置类，而实际应用中很多类并不需要（如数据访问相关配置在纯 Web 应用中无用）。排除这些无用的自动配置类可以减少 Spring 容器的 Bean 数量，提升启动速度。
排除方式有两种：
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, MybatisAutoConfiguration.class})
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
spring:
autoconfigure:
exclude:
- org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
- org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration
SpringBoot 默认在启动时初始化所有单例 Bean，对于一些非核心的自动配置 Bean（如监控、日志等），可以设置为延迟初始化，减少启动时的初始化压力，提升启动速度。
开启延迟初始化的方式：
spring:
main:
lazy-initialization: true
也可以在具体的自动配置类上添加@Lazy 注解，实现局部延迟初始化：
@Bean
@ConditionalOnMissingBean
@Lazy
public LogService logService() {
return new LogService(logProperties.getPrefix());
}
避免引入不必要的 starter 依赖（如纯 Web 应用无需引入 spring-boot-starter-data-jpa），减少自动配置类的扫描和加载数量。同时，使用 SpringBoot 的依赖管理功能（spring-boot-dependencies）统一管理依赖版本，避免版本冲突导致的自动配置异常。
本文围绕 SpringBoot 自动配置机制展开，从概念、原理、实战到优化，完整覆盖了自动配置的核心内容，关键知识点总结如下：
SpringBoot 自动配置是'约定优于配置'思想的实现，通过根据依赖、环境、配置自动推断并配置核心 Bean，解决传统 Spring 配置繁琐的问题，核心特性包括条件触发、优先级机制、环境感知和可扩展性。
自定义自动配置的核心流程包括：设计模块化项目结构（核心功能 + 自动配置）、编写配置属性类（绑定配置）、编写自动配置类（结合条件注解）、注册自动配置类，最终打包发布为 starter 供其他项目使用。
通过开启 debug 日志、使用 SpringBoot Actuator 可以快速定位自动配置问题；优化策略包括排除无用自动配置类、延迟初始化 Bean、优化依赖引入，提升应用启动效率。
在 Spring Cloud 微服务架构中，自动配置机制被进一步扩展。例如，Spring Cloud Netflix 的 eureka-client-starter 通过自动配置，将应用注册到 Eureka 服务端；Spring Cloud OpenFeign 的 feign-starter 自动配置 FeignClient 的核心组件，实现声明式服务调用。这些 starter 的底层实现原理与本文介绍的自定义 starter 一致，都是基于 SpringBoot 自动配置机制。
SpringBoot 3.x 版本基于 Spring Framework 6.x，对自动配置机制进行了部分优化：
为帮助读者进一步深入学习 SpringBoot 自动配置及相关技术，推荐以下优质资料：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online