文章 | Nanxu

通过 AOP 实现接口性能监控，自动记录每个接口的执行时间、请求路径等性能指标。

1.引入AOP所需依赖

添加 Spring AOP 框架依赖以支持切面编程功能。

    pom.xml
  
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

Nanxu2026/1/9大约 2 分钟

全局异常处理

全局异常处理机制用于捕获和处理应用程序中未被捕获的异常，提供统一的异常处理流程和响应格式。该机制不仅能够确保系统在发生异常时返回标准化的错误信息，还可以根据需要自定义异常处理后的操作，如将异常信息记录到数据库中进行后续分析。

注意

使用全局异常处理向数据库记录日志功能前，需要先完成异步记录日志的相关配置，如不需要此功能可以跳过相关配置。

Nanxu2026/1/7大约 3 分钟

异步记录日志

采用事件驱动模式实现异步记录登录日志到数据库，通过 Spring 的事件发布/监听机制将日志记录操作与业务逻辑解耦，避免日志记录对业务处理性能的影响。

1.异步配置类

配置异步执行所需的线程池资源和异常处理策略。

    AsyncConfig.java
  
@Configuration
@EnableAsync
@Slf4j
public class AsyncConfig implements AsyncConfigurer {
    /**
     * 创建异步线程池
     *
     * @return 线程池
     */
    @Override
    public @Nullable Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(2);
        executor.setMaxPoolSize(5);
        executor.setQueueCapacity(1000);
        // 设置线程名称前缀，方便查看日志
        executor.setThreadNamePrefix("log-async-");
        executor.initialize();
        return executor;
    }

    /**
     * 异步任务异常处理
     *
     * @return 异常处理
     */
    @Override
    public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return (throwable, method, params) -> {
            log.error("异步任务执行异常: ", throwable);
            log.error("异常方法: {}.{}", method.getDeclaringClass().getSimpleName(), method.getName());
        };
    }
}

Nanxu2026/1/7大约 3 分钟

地址工具类

地址工具类通过集成高德地图 API 实现根据用户 IP 地址查询地理位置信息的功能。

1. 技术实现

1.1 API 服务提供商

使用高德地图 IP 定位 API提供的 IP 地址定位服务，该服务能够根据 IP 地址返回对应的地理位置信息。

1.2 配置参数

addre.url: 高德地图 IP 定位 API 的请求地址
address.key: 高德地图开发者密钥，用于 API 调用认证

Nanxu2026/1/7小于 1 分钟

IP 工具类

IP 工具类用于获取用户真实 IP 地址，通过多种 HTTP 头信息和请求参数来获取客户端的原始 IP 地址，有效处理了经过代理服务器、负载均衡器等网络设备转发后的情况。

1.实现原理

按照优先级依次从以下 HTTP 头中获取 IP 地址：

X-Forwarded-For
X-Real-IP
X-Forwarded-Host
Proxy-Client-IP
WL-Proxy-Client-IP
HTTP_CLIENT_IP
HTTP_X_FORWARDED_FOR
最后使用 request.getRemoteAddr() 获取原始 IP

Nanxu2026/1/7大约 1 分钟

HTTP 工具类

WebClient 是 Spring WebFlux 提供的非阻塞式 HTTP 客户端，它支持同步和异步的调用方式，适合高并发场景下的服务通信。

1.引入相关依赖

在项目中引入 WebFlux 依赖来实现 HTTP 请求发送功能。

    pom.xml
  
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

Nanxu2026/1/7大约 1 分钟

Spring Security 认证

本项目使用 Spring Security 实现认证授权功能，结合 JWT 和 Redis 实现无状态认证机制。

1.引入相关依赖

在项目中引入 Spring Security 和 JWT 相关依赖来实现认证授权功能。

    pom.xml
  
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-api</artifactId>
    <version>0.13.0</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-impl</artifactId>
    <version>0.13.0</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-jackson</artifactId>
    <version>0.13.0</version>
</dependency>

Nanxu2025/11/5大约 23 分钟

Redis

1.引入 Redis 依赖

在项目中添加以下依赖以启用 Redis 功能。

    pom.xml
  
<!-- Spring Boot Redis Starter 依赖，提供 Redis 相关功能支持 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

<!-- Alibaba FastJSON2 依赖，用于高性能的 JSON 序列化和反序列化 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.60</version>
</dependency>

Nanxu2025/10/31大约 3 分钟

Swagger3

1.引入 Swagger3

通过 Maven 依赖引入 Swagger3 相关组件，为项目提供 API 文档生成功能支持。

    pom.xml
  
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
    <version>2.8.13</version>
</dependency>

Nanxu2025/10/29大约 1 分钟

SpringBoot 多环境配置

通过在pom.xml中配置 Profile，可以便捷地实现不同运行环境间的切换。

1.Maven 配置

在pom.xml文件中定义多个环境 Profile。

    pom.xml
  
<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <profileActive>dev</profileActive>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <profileActive>prod</profileActive>
        </properties>
    </profile>
</profiles>

Nanxu2025/10/23小于 1 分钟