clazz) {
+ JSONObject msg = JSONObject.parseObject(message);
+ LogTrack log = msg.getObject(LOG, LogTrack.class);
+ T data = msg.getObject(DATA, clazz);
+ return new MessageDto<>(log, data);
+ }
+}
diff --git a/xtools-boot-mq/xtools-boot-mq-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-mq/xtools-boot-mq-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..73b1ae0
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.mq.base.BootMqBaseConfiguration
\ No newline at end of file
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/pom.xml b/xtools-boot-mq/xtools-boot-mq-rabbit/pom.xml
new file mode 100644
index 0000000..b00fcf4
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/pom.xml
@@ -0,0 +1,35 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot-mq
+ 5.0.0
+
+ xtools-boot-mq-rabbit
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+ org.xujun
+ xtools-boot-mq-base
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-amqp
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/BootRabbitMqConfiguration.java b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/BootRabbitMqConfiguration.java
new file mode 100644
index 0000000..df45a8b
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/BootRabbitMqConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.mq.rabbit;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.mq.rabbit.selector.BootRabbitMqImportSelector;
+
+/**
+ * Title : BootRabbitMqConfiguration
+ * Description : BootRabbitMqConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootRabbitMqImportSelector.class)
+public class BootRabbitMqConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootRabbitMqConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootRabbitMqConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/handle/RabbitMqHandle.java b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/handle/RabbitMqHandle.java
new file mode 100644
index 0000000..d48a8dd
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/handle/RabbitMqHandle.java
@@ -0,0 +1,90 @@
+package xtools.boot.mq.rabbit.handle;
+
+import jakarta.annotation.Resource;
+import org.springframework.amqp.core.Queue;
+import org.springframework.amqp.rabbit.connection.ConnectionFactory;
+import org.springframework.amqp.rabbit.core.RabbitAdmin;
+import org.springframework.amqp.rabbit.core.RabbitTemplate;
+import org.springframework.amqp.rabbit.listener.SimpleMessageListenerContainer;
+import org.springframework.amqp.rabbit.listener.adapter.MessageListenerAdapter;
+import org.springframework.stereotype.Component;
+import xtools.boot.mq.base.handle.BaseMqHandle;
+import xtools.boot.mq.rabbit.params.RabbitMqParams;
+import xtools.core.StringUtils;
+
+/**
+ * Title : RabbitMqHandle
+ * Description : RabbitMqHandle
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/4 14:14
+ */
+@Component
+public class RabbitMqHandle implements BaseMqHandle {
+
+ /**
+ * 默认监听方法
+ */
+ private final static String DEFAULT_LISTENER_METHOD = "baseHandleMessage";
+
+ @Resource
+ private ConnectionFactory connectionFactory;
+
+ @Resource
+ private RabbitTemplate rabbitTemplate;
+
+ /**
+ * 初始化消息队列
+ *
+ * @param queueName 消息队列名称
+ */
+ @Override
+ public void initQueue(String queueName) {
+ Queue queue = new Queue(queueName, true);
+ new RabbitAdmin(connectionFactory).declareQueue(queue);
+ }
+
+ /**
+ * 添加消息队列监听
+ *
+ * @param queueName 消息队列
+ * @param delegate 监听类
+ * @param listenerMethod 监听方法
+ * @param params 参数
+ */
+ @Override
+ public void addListen(String queueName, Object delegate, String listenerMethod, Object params) {
+ if (StringUtils.isBlank(listenerMethod)) {
+ listenerMethod = DEFAULT_LISTENER_METHOD;
+ }
+ SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
+ container.setConnectionFactory(connectionFactory);
+ container.setQueueNames(queueName);
+ // 设置参数
+ if (params instanceof RabbitMqParams rabbitMqParams) {
+ // 并发参数
+ String concurrency = rabbitMqParams.getConcurrency();
+ if (StringUtils.isNotBlank(concurrency)) {
+ container.setConcurrency(concurrency);
+ }
+ }
+ container.setMessageListener(new MessageListenerAdapter(delegate, listenerMethod));
+ container.start();
+ }
+
+ /**
+ * 推送消息
+ *
+ * @param routingKey 路由 key
+ * @param data 消息数据
+ */
+ @Override
+ public void push(String routingKey, Object data) {
+ rabbitTemplate.convertAndSend(routingKey, data);
+ }
+
+}
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/params/RabbitMqParams.java b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/params/RabbitMqParams.java
new file mode 100644
index 0000000..61bcd9d
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/params/RabbitMqParams.java
@@ -0,0 +1,30 @@
+package xtools.boot.mq.rabbit.params;
+
+import java.io.Serializable;
+
+/**
+ * Title : RabbitMqParam
+ * Description : RabbitMqParam
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/12 08:05
+ */
+public class RabbitMqParams implements Serializable {
+
+ /**
+ * 并发
+ */
+ private String concurrency;
+
+ public String getConcurrency() {
+ return concurrency;
+ }
+
+ public void setConcurrency(String concurrency) {
+ this.concurrency = concurrency;
+ }
+}
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/selector/BootRabbitMqImportSelector.java b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/selector/BootRabbitMqImportSelector.java
new file mode 100644
index 0000000..97f5b3c
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/java/xtools/boot/mq/rabbit/selector/BootRabbitMqImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.mq.rabbit.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootRabbitMqImportSelector
+ * Description : BootRabbitMqImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootRabbitMqImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.mq.rabbit");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..b5073d4
--- /dev/null
+++ b/xtools-boot-mq/xtools-boot-mq-rabbit/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.mq.rabbit.BootRabbitMqConfiguration
\ No newline at end of file
diff --git a/xtools-boot-storage/pom.xml b/xtools-boot-storage/pom.xml
new file mode 100644
index 0000000..fac3750
--- /dev/null
+++ b/xtools-boot-storage/pom.xml
@@ -0,0 +1,21 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot
+ 5.0.0
+
+ pom
+ xtools-boot-storage
+
+
+
+ xtools-boot-storage-file
+ xtools-boot-storage-s3
+ xtools-boot-storage-base
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-base/pom.xml b/xtools-boot-storage/xtools-boot-storage-base/pom.xml
new file mode 100644
index 0000000..5d725be
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/pom.xml
@@ -0,0 +1,30 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot-storage
+ 5.0.0
+
+ xtools-boot-storage-base
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+
+
+ org.springframework.boot
+ spring-boot
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/BootStorageBaseConfiguration.java b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/BootStorageBaseConfiguration.java
new file mode 100644
index 0000000..46eb230
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/BootStorageBaseConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.storage.base;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.storage.base.selector.BootStorageBaseImportSelector;
+
+/**
+ * Title : BootStorageBaseConfiguration
+ * Description : BootStorageBaseConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootStorageBaseImportSelector.class)
+public class BootStorageBaseConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootStorageBaseConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootStorageBaseConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/config/StorageConfig.java b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/config/StorageConfig.java
new file mode 100644
index 0000000..2d4fd90
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/config/StorageConfig.java
@@ -0,0 +1,77 @@
+package xtools.boot.storage.base.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * Title : StorageConfig
+ * Description : StorageConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:40
+ */
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "storage")
+public class StorageConfig {
+
+ /**
+ * 存储类型[file|s3]
+ */
+ private String type = "file";
+
+ /**
+ * 文件类型
+ */
+ private FileType file;
+
+ /**
+ * S3类型
+ */
+ private S3Type s3;
+
+ /**
+ * 文件类型
+ */
+ @Data
+ public static class FileType {
+
+ /**
+ * 文件存储路径
+ */
+ private String path;
+ }
+
+ /**
+ * S3类型
+ */
+ @Data
+ public static class S3Type {
+
+ /**
+ * 服务类型[rustfs]
+ */
+ private String server = "default";
+
+ /**
+ * 地址
+ */
+ private String host;
+
+ /**
+ * 密钥ID
+ */
+ private String accessKeyId;
+
+ /**
+ * 密钥
+ */
+ private String secretAccessKey;
+ }
+
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/selector/BootStorageBaseImportSelector.java b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/selector/BootStorageBaseImportSelector.java
new file mode 100644
index 0000000..b6b3dca
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/selector/BootStorageBaseImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.storage.base.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootStorageBaseImportSelector
+ * Description : BootStorageBaseImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootStorageBaseImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.storage.base");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/service/StorageService.java b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/service/StorageService.java
new file mode 100644
index 0000000..d376420
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/java/xtools/boot/storage/base/service/StorageService.java
@@ -0,0 +1,72 @@
+package xtools.boot.storage.base.service;
+
+import jakarta.validation.constraints.NotNull;
+
+import java.io.InputStream;
+import java.io.OutputStream;
+
+/**
+ * Title : StorageService
+ * Description : StorageService
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:20
+ */
+public interface StorageService {
+
+ /**
+ * 是否存在文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @return true or false
+ */
+ boolean exists(
+ @NotNull String bucket,
+ @NotNull String fileName
+ );
+
+ /**
+ * 保存文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param inputStream 输入流
+ * @param contentLength 文件长度
+ */
+ void save(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull InputStream inputStream,
+ long contentLength
+ );
+
+ /**
+ * 获取文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param outputStream 输出流
+ */
+ void get(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull OutputStream outputStream
+ );
+
+ /**
+ * 删除文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ */
+ void del(
+ @NotNull String bucket,
+ @NotNull String fileName
+ );
+
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..4a4342f
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.storage.base.BootStorageBaseConfiguration
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/application-boot-storage-demo.yaml b/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/application-boot-storage-demo.yaml
new file mode 100644
index 0000000..10ee6db
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-base/src/main/resources/application-boot-storage-demo.yaml
@@ -0,0 +1,18 @@
+# 存储配置
+storage:
+ # 存储类型[file|s3](并且需要引入对应的jar包)
+ type: ${STORAGE_TYPE:file}
+ # 文件类型
+ file:
+ # 文件存储路径
+ path: ${STORAGE_FILE_PATH:/data/xtools/file}
+ # S3类型
+ s3:
+ # 服务类型(可为空)[rustfs]
+ server: ${STORAGE_S3_SERVER:rustfs}
+ # 地址
+ host: ${STORAGE_S3_HOST:http://127.0.0.1:9000}
+ # 密钥ID
+ accessKeyId: ${STORAGE_S3_ACCESS_KEY_ID:admin}
+ # 密钥
+ secretAccessKey: ${STORAGE_S3_SECRET_ACCESS_KEY:123456}
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-file/pom.xml b/xtools-boot-storage/xtools-boot-storage-file/pom.xml
new file mode 100644
index 0000000..3c68eb5
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/pom.xml
@@ -0,0 +1,41 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot-storage
+ 5.0.0
+
+ xtools-boot-storage-file
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+ org.xujun
+ xtools-boot-storage-base
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-autoconfigure
+
+
+
+
+ jakarta.annotation
+ jakarta.annotation-api
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/BootStorageFileConfiguration.java b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/BootStorageFileConfiguration.java
new file mode 100644
index 0000000..6fd3df6
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/BootStorageFileConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.storage.file;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.storage.file.selector.BootStorageFileImportSelector;
+
+/**
+ * Title : BootStorageFileConfiguration
+ * Description : BootStorageFileConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootStorageFileImportSelector.class)
+public class BootStorageFileConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootStorageFileConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootStorageFileConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/config/FileStorageConfig.java b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/config/FileStorageConfig.java
new file mode 100644
index 0000000..2b71a05
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/config/FileStorageConfig.java
@@ -0,0 +1,33 @@
+package xtools.boot.storage.file.config;
+
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import xtools.boot.storage.base.service.StorageService;
+import xtools.boot.storage.file.service.impl.StorageServiceFileImpl;
+
+/**
+ * Title : FileStorageConfig
+ * Description : FileStorageConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:53
+ */
+@Configuration
+public class FileStorageConfig {
+
+ /**
+ * 创建文件存储服务
+ *
+ * @return StorageService
+ */
+ @Bean
+ @ConditionalOnProperty(prefix = "storage", name = "type", havingValue = "file")
+ public StorageService fileStorage() {
+ return new StorageServiceFileImpl();
+ }
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/selector/BootStorageFileImportSelector.java b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/selector/BootStorageFileImportSelector.java
new file mode 100644
index 0000000..f84bde9
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/selector/BootStorageFileImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.storage.file.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootStorageFileImportSelector
+ * Description : BootStorageFileImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootStorageFileImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.storage.file");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/service/impl/StorageServiceFileImpl.java b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/service/impl/StorageServiceFileImpl.java
new file mode 100644
index 0000000..57f86a8
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/src/main/java/xtools/boot/storage/file/service/impl/StorageServiceFileImpl.java
@@ -0,0 +1,159 @@
+package xtools.boot.storage.file.service.impl;
+
+import jakarta.annotation.Resource;
+import jakarta.validation.constraints.NotNull;
+import lombok.extern.slf4j.Slf4j;
+import xtools.base.config.BaseParams;
+import xtools.boot.api.exection.BizError;
+import xtools.boot.storage.base.config.StorageConfig;
+import xtools.boot.storage.base.service.StorageService;
+import xtools.core.FileUtils;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.InputStream;
+import java.io.OutputStream;
+
+/**
+ * Title : StorageServiceS3Impl
+ * Description : StorageServiceS3Impl
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:35
+ */
+@Slf4j
+public class StorageServiceFileImpl implements StorageService, BaseParams {
+
+ @Resource
+ private StorageConfig storageConfig;
+
+ /**
+ * 是否存在文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @return true or false
+ */
+ @Override
+ public boolean exists(
+ @NotNull String bucket,
+ @NotNull String fileName
+ ) {
+ initBucket(bucket);
+ File file = new File(getFilePath(bucket, fileName));
+ return file.exists();
+ }
+
+ /**
+ * 保存文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param inputStream 输入流
+ * @param contentLength 文件长度
+ */
+ @Override
+ public void save(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull InputStream inputStream,
+ long contentLength
+ ) {
+ initBucket(bucket);
+ File file = new File(getFilePath(bucket, fileName));
+ try (OutputStream outputStream = new FileOutputStream(file)) {
+ byte[] bytes = new byte[CP_NUM1024];
+ int len;
+ while ((len = inputStream.read(bytes)) != CP_NEGATIVE1) {
+ outputStream.write(bytes, CP_NUM0, len);
+ }
+ } catch (Exception e) {
+ log.error("保存文件失败", e);
+ throw new BizError("保存文件失败");
+ }
+ }
+
+ /**
+ * 获取文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param outputStream 输出流
+ */
+ @Override
+ public void get(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull OutputStream outputStream
+ ) {
+ initBucket(bucket);
+ try (InputStream inputStream = new FileInputStream(getFilePath(bucket, fileName))) {
+ byte[] bytes = new byte[CP_NUM1024];
+ int len;
+ while ((len = inputStream.read(bytes)) != CP_NEGATIVE1) {
+ outputStream.write(bytes, CP_NUM0, len);
+ }
+ } catch (Exception e) {
+ log.error("获取文件失败", e);
+ throw new BizError("获取文件失败");
+ }
+ }
+
+ /**
+ * 删除文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ */
+ @Override
+ public void del(
+ @NotNull String bucket,
+ @NotNull String fileName
+ ) {
+ initBucket(bucket);
+ FileUtils.del(getFilePath(bucket, fileName));
+ }
+
+ /**
+ * 初始化桶
+ *
+ * @param bucket 桶
+ */
+ private void initBucket(String bucket) {
+ String path = getPath(bucket);
+ File file = new File(path);
+ if (file.exists()) {
+ return;
+ }
+ if (file.mkdirs()) {
+ return;
+ }
+ throw new BizError("创建目录失败" + path);
+ }
+
+ /**
+ * 获取路径
+ *
+ * @param bucket 桶
+ * @return 路径
+ */
+ private String getPath(String bucket) {
+ return storageConfig.getFile().getPath() + CP_SLASH + bucket;
+ }
+
+ /**
+ * 获取文件路径
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @return 文件路径
+ */
+ private String getFilePath(String bucket, String fileName) {
+ return getPath(bucket) + CP_SLASH + fileName;
+ }
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-file/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-storage/xtools-boot-storage-file/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..8a14b28
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-file/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.storage.file.BootStorageFileConfiguration
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/pom.xml b/xtools-boot-storage/xtools-boot-storage-s3/pom.xml
new file mode 100644
index 0000000..5c6fee5
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/pom.xml
@@ -0,0 +1,55 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot-storage
+ 5.0.0
+
+ xtools-boot-storage-s3
+
+
+
+
+
+
+
+ software.amazon.awssdk
+ s3
+
+
+ org.xujun
+ xtools-extend
+
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+ org.xujun
+ xtools-boot-storage-base
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-autoconfigure
+
+
+
+
+ jakarta.annotation
+ jakarta.annotation-api
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/BootStorageS3Configuration.java b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/BootStorageS3Configuration.java
new file mode 100644
index 0000000..0928f76
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/BootStorageS3Configuration.java
@@ -0,0 +1,28 @@
+package xtools.boot.storage.s3;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.storage.s3.selector.BootStorageS3ImportSelector;
+
+/**
+ * Title : BootStorageS3Configuration
+ * Description : BootStorageS3Configuration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootStorageS3ImportSelector.class)
+public class BootStorageS3Configuration {
+
+ /**
+ * 构造方法
+ */
+ public BootStorageS3Configuration() {
+ ModuleLoadUtils.loadSuccess(BootStorageS3Configuration.class);
+ }
+
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/config/S3StorageConfig.java b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/config/S3StorageConfig.java
new file mode 100644
index 0000000..a94fd0d
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/config/S3StorageConfig.java
@@ -0,0 +1,75 @@
+package xtools.boot.storage.s3.config;
+
+import jakarta.annotation.Resource;
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import software.amazon.awssdk.regions.Region;
+import software.amazon.awssdk.services.s3.S3Client;
+import xtools.boot.storage.base.config.StorageConfig;
+import xtools.boot.storage.base.service.StorageService;
+import xtools.boot.storage.s3.service.impl.StorageServiceS3Impl;
+import xtools.extend.S3Utils;
+
+/**
+ * Title : S3StorageConfig
+ * Description : S3StorageConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:53
+ */
+@Configuration
+public class S3StorageConfig {
+
+ @Resource
+ private StorageConfig storageConfig;
+
+ /**
+ * 创建S3默认客户端
+ *
+ * @return S3Client
+ */
+ @Bean
+ @ConditionalOnProperty(prefix = "storage", name = "type", havingValue = "s3")
+ @ConditionalOnProperty(prefix = "storage.s3", name = "server", havingValue = "default")
+ public S3Client defaultClient() {
+ return S3Utils.client(
+ storageConfig.getS3().getHost(),
+ storageConfig.getS3().getAccessKeyId(),
+ storageConfig.getS3().getSecretAccessKey(),
+ Region.CN_NORTH_1,
+ true
+ );
+ }
+
+ /**
+ * 创建S3-rustfs客户端
+ *
+ * @return S3Client
+ */
+ @Bean
+ @ConditionalOnProperty(prefix = "storage", name = "type", havingValue = "s3")
+ @ConditionalOnProperty(prefix = "storage.s3", name = "server", havingValue = "rustfs")
+ public S3Client rustfsClient() {
+ return S3Utils.rustfsClient(
+ storageConfig.getS3().getHost(),
+ storageConfig.getS3().getAccessKeyId(),
+ storageConfig.getS3().getSecretAccessKey()
+ );
+ }
+
+ /**
+ * 创建S3存储服务
+ *
+ * @return StorageService
+ */
+ @Bean
+ @ConditionalOnProperty(prefix = "storage", name = "type", havingValue = "s3")
+ public StorageService s3Storage() {
+ return new StorageServiceS3Impl();
+ }
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/selector/BootStorageS3ImportSelector.java b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/selector/BootStorageS3ImportSelector.java
new file mode 100644
index 0000000..5917b52
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/selector/BootStorageS3ImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.storage.s3.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootStorageS3ImportSelector
+ * Description : BootStorageS3ImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootStorageS3ImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.storage.s3");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/service/impl/StorageServiceS3Impl.java b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/service/impl/StorageServiceS3Impl.java
new file mode 100644
index 0000000..9ed88c0
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/src/main/java/xtools/boot/storage/s3/service/impl/StorageServiceS3Impl.java
@@ -0,0 +1,121 @@
+package xtools.boot.storage.s3.service.impl;
+
+import jakarta.annotation.Resource;
+import jakarta.validation.constraints.NotNull;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import software.amazon.awssdk.services.s3.S3Client;
+import xtools.base.config.BaseParams;
+import xtools.boot.storage.base.service.StorageService;
+import xtools.extend.S3Utils;
+
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Title : StorageServiceS3Impl
+ * Description : StorageServiceS3Impl
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/14 07:35
+ */
+@Slf4j
+@RequiredArgsConstructor
+public class StorageServiceS3Impl implements StorageService, BaseParams {
+
+ /**
+ * 桶集合
+ */
+ private final static Set BUCKET_SET = new HashSet<>();
+
+ @Resource
+ private S3Client s3Client;
+
+ /**
+ * 是否存在文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @return true or false
+ */
+ @Override
+ public boolean exists(
+ @NotNull String bucket,
+ @NotNull String fileName
+ ) {
+ initBucket(bucket);
+ return S3Utils.exists(s3Client, bucket, fileName);
+ }
+
+ /**
+ * 保存文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param inputStream 输入流
+ * @param contentLength 文件长度
+ */
+ @Override
+ public void save(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull InputStream inputStream,
+ long contentLength
+ ) {
+ initBucket(bucket);
+ S3Utils.upload(s3Client, bucket, fileName, inputStream, contentLength);
+ }
+
+ /**
+ * 获取文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ * @param outputStream 输出流
+ */
+ @Override
+ public void get(
+ @NotNull String bucket,
+ @NotNull String fileName,
+ @NotNull OutputStream outputStream
+ ) {
+ S3Utils.download(s3Client, bucket, fileName, outputStream);
+ }
+
+ /**
+ * 删除文件
+ *
+ * @param bucket 桶
+ * @param fileName 文件名
+ */
+ @Override
+ public void del(
+ @NotNull String bucket,
+ @NotNull String fileName
+ ) {
+ S3Utils.delete(s3Client, bucket, fileName);
+ }
+
+ /**
+ * 初始化桶
+ *
+ * @param bucket 桶
+ */
+ private void initBucket(String bucket) {
+ if (BUCKET_SET.contains(bucket)) {
+ return;
+ }
+ try {
+ S3Utils.createBucket(s3Client, bucket);
+ } catch (Exception e) {
+ log.info("文件桶已存在", e);
+ }
+ BUCKET_SET.add(bucket);
+ }
+}
diff --git a/xtools-boot-storage/xtools-boot-storage-s3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-storage/xtools-boot-storage-s3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..0c2343c
--- /dev/null
+++ b/xtools-boot-storage/xtools-boot-storage-s3/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.storage.s3.BootStorageS3Configuration
\ No newline at end of file
diff --git a/xtools-boot-task/pom.xml b/xtools-boot-task/pom.xml
new file mode 100644
index 0000000..48bc220
--- /dev/null
+++ b/xtools-boot-task/pom.xml
@@ -0,0 +1,24 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot
+ 5.0.0
+
+ xtools-boot-task
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/BootTaskConfiguration.java b/xtools-boot-task/src/main/java/xtools/boot/task/BootTaskConfiguration.java
new file mode 100644
index 0000000..5a53720
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/BootTaskConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.task;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.task.selector.BootTaskImportSelector;
+
+/**
+ * Title : BootTaskConfiguration
+ * Description : BootTaskConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootTaskImportSelector.class)
+public class BootTaskConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootTaskConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootTaskConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/TaskBus.java b/xtools-boot-task/src/main/java/xtools/boot/task/TaskBus.java
new file mode 100644
index 0000000..bf03c7b
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/TaskBus.java
@@ -0,0 +1,111 @@
+package xtools.boot.task;
+
+import xtools.boot.api.exection.BizError;
+import xtools.boot.core.utils.SpringContextUtils;
+import xtools.boot.task.enums.TaskStatus;
+import xtools.boot.task.interfaces.BaseTaskType;
+import xtools.boot.task.interfaces.TaskBusInterface;
+import xtools.boot.task.model.dto.TaskInfo;
+import xtools.core.CollectionUtils;
+import xtools.core.StringUtils;
+
+import java.time.Instant;
+import java.util.Collection;
+import java.util.Objects;
+
+/**
+ * Title : TaskBus
+ * Description : TaskBus
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/15 10:07
+ */
+public class TaskBus {
+
+ /**
+ * 任务数据
+ **/
+ private final TaskInfo taskInfo;
+
+ /**
+ * 构造方法
+ *
+ * @param code 任务编码
+ * @param type 任务类型
+ * @param status 任务状态
+ */
+ private TaskBus(String code, BaseTaskType type, TaskStatus status) {
+ // 参数处理
+ if (StringUtils.isBlank(code)) {
+ throw new BizError("任务Code不能为空");
+ }
+ if (type == null) {
+ throw new BizError("任务类型不能为空");
+ }
+ if (status == null) {
+ throw new BizError("任务状态不能为空");
+ }
+ taskInfo = new TaskInfo();
+ // 参数赋值
+ taskInfo.setCode(code);
+ taskInfo.setType(type.desc());
+ taskInfo.setStatus(status);
+ taskInfo.setInfo(type.desc() + "-" + status.desc());
+ taskInfo.setTime(Instant.now());
+ }
+
+ /**
+ * 初始化任务
+ *
+ * @param code 任务编码
+ * @param type 任务类型
+ * @param status 任务状态
+ * @return 当前对象
+ */
+ public static TaskBus init(String code, BaseTaskType type, TaskStatus status) {
+ return new TaskBus(code, type, status);
+ }
+
+ /**
+ * 设置任务信息
+ *
+ * @param info 任务信息
+ * @return 当前对象
+ */
+ public TaskBus info(String info) {
+ if (StringUtils.isBlank(info)) {
+ throw new BizError("任务信息不能为空");
+ }
+ taskInfo.setInfo(info);
+ return this;
+ }
+
+ /**
+ * 设置任务时间
+ *
+ * @param time 任务时间
+ * @return 当前对象
+ */
+ public TaskBus time(Instant time) {
+ if (Objects.isNull(time)) {
+ throw new BizError("任务时间不能为空");
+ }
+ taskInfo.setTime(time);
+ return this;
+ }
+
+ /**
+ * 保存任务
+ */
+ public void save() {
+ Collection beanList = SpringContextUtils.getBeanList(TaskBusInterface.class);
+ if (CollectionUtils.isNotEmpty(beanList)) {
+ beanList.forEach(item -> item.save(taskInfo));
+ }
+ }
+
+}
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/enums/TaskStatus.java b/xtools-boot-task/src/main/java/xtools/boot/task/enums/TaskStatus.java
new file mode 100644
index 0000000..66af697
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/enums/TaskStatus.java
@@ -0,0 +1,91 @@
+package xtools.boot.task.enums;
+
+import xtools.boot.api.enums.BaseEnum;
+
+/**
+ * Title : TaskStatus
+ * Description : TaskStatus
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/3 10:31
+ */
+public enum TaskStatus implements BaseEnum {
+
+ // 任务进行中
+ ING(0, "进行中"),
+ // 任务成功
+ SUCCESS(1, "任务成功"),
+ // 任务失败
+ ERROR(2, "任务失败");
+
+ /**
+ * 编码
+ */
+ private final int code;
+
+ /**
+ * 说明
+ */
+ private final String desc;
+
+ /**
+ * 初始化方法
+ *
+ * @param code Code
+ * @param desc 说明
+ */
+ TaskStatus(int code, String desc) {
+ this.code = code;
+ this.desc = desc;
+ }
+
+ /**
+ * 判断枚举值类型
+ *
+ * @param code 枚举值
+ * @return 枚举值类型
+ */
+ public static TaskStatus valueOf(int code) {
+ for (TaskStatus type : values()) {
+ if (type.code == code) {
+ return type;
+ }
+ }
+ throw new IllegalArgumentException("unknown code, code=" + code);
+ }
+
+ /**
+ * 获取所有枚举
+ *
+ * @return 所有枚举
+ */
+ @Override
+ public BaseEnum[] all() {
+ return values();
+ }
+
+ /**
+ * 获取枚举编码
+ *
+ * @return 枚举编码
+ */
+ @Override
+ public int code() {
+ return code;
+ }
+
+ /**
+ * 获取枚举说明
+ *
+ * @return 枚举说明
+ */
+ @Override
+ public String desc() {
+ return desc;
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/BaseTaskType.java b/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/BaseTaskType.java
new file mode 100644
index 0000000..462ef4c
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/BaseTaskType.java
@@ -0,0 +1,17 @@
+package xtools.boot.task.interfaces;
+
+import xtools.boot.api.enums.BaseEnum;
+
+/**
+ * Title : BaseTaskType
+ * Description : BaseTaskType
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/15 09:52
+ */
+public interface BaseTaskType extends BaseEnum {
+}
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/TaskBusInterface.java b/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/TaskBusInterface.java
new file mode 100644
index 0000000..e100c22
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/interfaces/TaskBusInterface.java
@@ -0,0 +1,25 @@
+package xtools.boot.task.interfaces;
+
+import xtools.boot.task.model.dto.TaskInfo;
+
+/**
+ * Title : TaskBusInterface
+ * Description : TaskBusInterface
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/15 10:16
+ */
+public interface TaskBusInterface {
+
+ /**
+ * 保存任务
+ *
+ * @param taskInfo 任务
+ */
+ void save(TaskInfo taskInfo);
+
+}
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/model/dto/TaskInfo.java b/xtools-boot-task/src/main/java/xtools/boot/task/model/dto/TaskInfo.java
new file mode 100644
index 0000000..8bce1e8
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/model/dto/TaskInfo.java
@@ -0,0 +1,47 @@
+package xtools.boot.task.model.dto;
+
+import lombok.Data;
+import xtools.boot.task.enums.TaskStatus;
+
+import java.io.Serializable;
+import java.time.Instant;
+
+/**
+ * Title : TaskInfo
+ * Description : TaskInfo
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/15 10:07
+ */
+@Data
+public class TaskInfo implements Serializable {
+
+ /**
+ * 任务编码
+ */
+ private String code;
+
+ /**
+ * 任务类型
+ */
+ private String type;
+
+ /**
+ * 任务状态
+ */
+ private TaskStatus status;
+
+ /**
+ * 任务信息
+ */
+ private String info;
+
+ /**
+ * 任务时间
+ */
+ private Instant time;
+}
\ No newline at end of file
diff --git a/xtools-boot-task/src/main/java/xtools/boot/task/selector/BootTaskImportSelector.java b/xtools-boot-task/src/main/java/xtools/boot/task/selector/BootTaskImportSelector.java
new file mode 100644
index 0000000..ce719ec
--- /dev/null
+++ b/xtools-boot-task/src/main/java/xtools/boot/task/selector/BootTaskImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.task.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootTaskImportSelector
+ * Description : BootTaskImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootTaskImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.task");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-task/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-task/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..77d1bc0
--- /dev/null
+++ b/xtools-boot-task/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.task.BootTaskConfiguration
\ No newline at end of file
diff --git a/xtools-boot-thread/pom.xml b/xtools-boot-thread/pom.xml
new file mode 100644
index 0000000..0ff297d
--- /dev/null
+++ b/xtools-boot-thread/pom.xml
@@ -0,0 +1,29 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot
+ 5.0.0
+
+ xtools-boot-thread
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+ org.xujun
+ xtools-boot-log
+
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-thread/src/main/java/xtools/boot/thread/BootThreadConfiguration.java b/xtools-boot-thread/src/main/java/xtools/boot/thread/BootThreadConfiguration.java
new file mode 100644
index 0000000..6549238
--- /dev/null
+++ b/xtools-boot-thread/src/main/java/xtools/boot/thread/BootThreadConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.thread;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.thread.selector.BootThreadImportSelector;
+
+/**
+ * Title : BootThreadConfiguration
+ * Description : BootThreadConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootThreadImportSelector.class)
+public class BootThreadConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootThreadConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootThreadConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-thread/src/main/java/xtools/boot/thread/callback/VirtualThreadTaskCallback.java b/xtools-boot-thread/src/main/java/xtools/boot/thread/callback/VirtualThreadTaskCallback.java
new file mode 100644
index 0000000..c8eb1c0
--- /dev/null
+++ b/xtools-boot-thread/src/main/java/xtools/boot/thread/callback/VirtualThreadTaskCallback.java
@@ -0,0 +1,21 @@
+package xtools.boot.thread.callback;
+
+/**
+ * Title : VirtualThreadTaskCallback
+ * Description : VirtualThreadTaskCallback
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/8 20:48
+ */
+public interface VirtualThreadTaskCallback {
+
+ /**
+ * 回调方法
+ */
+ void callback();
+
+}
diff --git a/xtools-boot-thread/src/main/java/xtools/boot/thread/selector/BootThreadImportSelector.java b/xtools-boot-thread/src/main/java/xtools/boot/thread/selector/BootThreadImportSelector.java
new file mode 100644
index 0000000..ffec8ef
--- /dev/null
+++ b/xtools-boot-thread/src/main/java/xtools/boot/thread/selector/BootThreadImportSelector.java
@@ -0,0 +1,36 @@
+package xtools.boot.thread.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * Title : BootThreadImportSelector
+ * Description : BootThreadImportSelector
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootThreadImportSelector implements ImportBeanDefinitionRegistrar {
+
+ /**
+ * 根据给定的注释元数据,根据需要注册bean
+ *
+ * @param importingClassMetadata AnnotationMetadata
+ * @param registry BeanDefinitionRegistry
+ */
+ @Override
+ public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+ // 构建扫描对象
+ ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+ // 扫描包下路径
+ scanner.scan("xtools.boot.thread");
+ }
+
+}
\ No newline at end of file
diff --git a/xtools-boot-thread/src/main/java/xtools/boot/thread/utils/VirtualThreadTaskUtils.java b/xtools-boot-thread/src/main/java/xtools/boot/thread/utils/VirtualThreadTaskUtils.java
new file mode 100644
index 0000000..8ba120e
--- /dev/null
+++ b/xtools-boot-thread/src/main/java/xtools/boot/thread/utils/VirtualThreadTaskUtils.java
@@ -0,0 +1,82 @@
+package xtools.boot.thread.utils;
+
+import lombok.extern.slf4j.Slf4j;
+import xtools.boot.api.model.dto.log.HolderLogTrack;
+import xtools.boot.api.model.dto.log.LogTrack;
+import xtools.boot.log.LogBus;
+import xtools.boot.log.enums.LogBusBaseType;
+import xtools.boot.log.holder.LogTrackHolder;
+import xtools.boot.thread.callback.VirtualThreadTaskCallback;
+import xtools.core.enums.LogLevel;
+
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * Title : VirtualThreadTaskUtils
+ * Description : VirtualThreadTaskUtils
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/8 20:46
+ */
+@Slf4j
+public class VirtualThreadTaskUtils {
+
+ /**
+ * 创建子线程并执行任务(不带日志记录,不推荐)
+ *
+ * @param callback 回调
+ */
+ public static void simple(VirtualThreadTaskCallback callback) {
+ ExecutorService service = Executors.newVirtualThreadPerTaskExecutor();
+ try {
+ // 创建子线程,并异步提交
+ CompletableFuture.runAsync(() -> {
+ try {
+ callback.callback();
+ } catch (Exception e) {
+ log.error("子线程执行异常", e);
+ }
+ }, service);
+ } finally {
+ // 关闭线程池
+ service.shutdown();
+ }
+ }
+
+ /**
+ * 创建子线程并执行任务(带日志记录,推荐)
+ *
+ * @param callback 回调
+ */
+ public static void execute(VirtualThreadTaskCallback callback) {
+ // 获取父线程的追踪日志信息
+ LogTrack logTrack = LogTrackHolder.get();
+ LogBus.init(LogLevel.INFO, LogBusBaseType.VIRTUAL_THREAD, logTrack).title("创建虚拟线程").save();
+ ExecutorService service = Executors.newVirtualThreadPerTaskExecutor();
+ try {
+ // 创建子线程,并异步提交
+ CompletableFuture.runAsync(() -> {
+ // 生成子线程的追踪日志信息
+ HolderLogTrack holderLogTrack = LogTrackHolder.newThread(logTrack);
+ ScopedValue.where(LogTrackHolder.getScoped(), holderLogTrack).run(() -> {
+ try {
+ callback.callback();
+ } catch (Exception e) {
+ LogBus.init(LogLevel.ERROR, LogBusBaseType.VIRTUAL_THREAD).error(e).title("子线程执行异常").save();
+ }
+ });
+ }, service);
+ } finally {
+ // 关闭线程池
+ service.shutdown();
+ }
+ }
+
+
+}
diff --git a/xtools-boot-thread/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/xtools-boot-thread/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
new file mode 100644
index 0000000..d2ca89f
--- /dev/null
+++ b/xtools-boot-thread/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
@@ -0,0 +1 @@
+xtools.boot.thread.BootThreadConfiguration
\ No newline at end of file
diff --git a/xtools-boot-web/pom.xml b/xtools-boot-web/pom.xml
new file mode 100644
index 0000000..3452bdc
--- /dev/null
+++ b/xtools-boot-web/pom.xml
@@ -0,0 +1,20 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot
+ 5.0.0
+
+ pom
+ xtools-boot-web
+
+
+
+ xtools-boot-web-base
+ xtools-boot-web-filter
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-web/xtools-boot-web-base/pom.xml b/xtools-boot-web/xtools-boot-web-base/pom.xml
new file mode 100644
index 0000000..af4f6fe
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/pom.xml
@@ -0,0 +1,61 @@
+
+
+ 4.0.0
+
+ org.xujun
+ xtools-boot-web
+ 5.0.0
+
+ xtools-boot-web-base
+
+
+
+
+
+
+ org.xujun
+ xtools-web
+
+
+
+
+
+
+ org.xujun
+ xtools-boot-core
+
+
+
+ org.xujun
+ xtools-boot-log
+
+
+
+ org.xujun
+ xtools-boot-web-filter
+
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+
+ org.springframework.boot
+ spring-boot-starter-validation
+
+
+
+
+
+ com.alibaba.fastjson2
+ fastjson2
+
+
+
+
\ No newline at end of file
diff --git a/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/BootWebBaseConfiguration.java b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/BootWebBaseConfiguration.java
new file mode 100644
index 0000000..a82fa73
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/BootWebBaseConfiguration.java
@@ -0,0 +1,28 @@
+package xtools.boot.web.base;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.web.base.selector.BootWebBaseImportSelector;
+
+/**
+ * Title : BootWebBaseConfiguration
+ * Description : BootWebBaseConfiguration
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootWebBaseImportSelector.class)
+public class BootWebBaseConfiguration {
+
+ /**
+ * 构造方法
+ */
+ public BootWebBaseConfiguration() {
+ ModuleLoadUtils.loadSuccess(BootWebBaseConfiguration.class);
+ }
+
+}
diff --git a/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/JacksonConfig.java b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/JacksonConfig.java
new file mode 100644
index 0000000..78c9fce
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/JacksonConfig.java
@@ -0,0 +1,135 @@
+package xtools.boot.web.base.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import tools.jackson.core.JacksonException;
+import tools.jackson.core.JsonGenerator;
+import tools.jackson.core.JsonParser;
+import tools.jackson.databind.BeanProperty;
+import tools.jackson.databind.DeserializationContext;
+import tools.jackson.databind.SerializationContext;
+import tools.jackson.databind.ValueDeserializer;
+import tools.jackson.databind.ValueSerializer;
+import tools.jackson.databind.json.JsonMapper;
+import tools.jackson.databind.module.SimpleModule;
+import xtools.boot.api.anntation.IgnoreXss;
+import xtools.boot.core.utils.TimeUtils;
+import xtools.core.time.InstantUtils;
+import xtools.web.xss.XssUtils;
+
+import java.time.Instant;
+import java.util.Objects;
+
+/**
+ * Title : JacksonConfig
+ * Description : JacksonConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/1/6 12:15
+ */
+@Configuration
+public class JacksonConfig {
+
+ /**
+ * 忽略 null 值
+ */
+ public static final JsonMapper NON_NULL;
+
+ // 初始化
+ static {
+ NON_NULL = JsonMapper.builder().changeDefaultPropertyInclusion(handler -> handler.withValueInclusion(JsonInclude.Include.NON_NULL)).build();
+ }
+
+ /**
+ * 创建 SimpleModule
+ *
+ * @return SimpleModule
+ */
+ @Bean
+ public SimpleModule simpleModule() {
+ SimpleModule module = new SimpleModule();
+
+ // 序列化
+ module.addSerializer(Long.class, new ValueSerializer<>() {
+ @Override
+ public void serialize(Long value, JsonGenerator gen, SerializationContext context) throws JacksonException {
+ if (value == null) {
+ gen.writeNull();
+ } else {
+ gen.writeString(value.toString());
+ }
+ }
+ });
+ module.addSerializer(Instant.class, new ValueSerializer<>() {
+ @Override
+ public void serialize(Instant value, JsonGenerator gen, SerializationContext context) throws JacksonException {
+ if (value == null) {
+ gen.writeNull();
+ } else {
+ gen.writeString(InstantUtils.format(value));
+ }
+ }
+ });
+
+ // 反序列化
+ module.addDeserializer(Instant.class, new ValueDeserializer<>() {
+ @Override
+ public Instant deserialize(JsonParser p, DeserializationContext context) throws JacksonException {
+ return TimeUtils.toInstant(p.getString());
+ }
+ });
+ // xss处理
+ module.addDeserializer(String.class, new XssStringDeserializer());
+
+ return module;
+ }
+
+ /**
+ * XSS 字符串反序列化器
+ */
+ static class XssStringDeserializer extends ValueDeserializer {
+
+ /**
+ * 是否忽略 XSS 过滤
+ */
+ private final boolean ignore;
+
+ /**
+ * 创建 XSS 忽略字符串反序列化器
+ */
+ XssStringDeserializer() {
+ this(false);
+ }
+
+ /**
+ * 创建 XSS 忽略字符串反序列化器
+ *
+ * @param ignore 是否忽略 XSS 过滤
+ */
+ XssStringDeserializer(boolean ignore) {
+ this.ignore = ignore;
+ }
+
+ @Override
+ public String deserialize(JsonParser parser, DeserializationContext context) throws JacksonException {
+ String value = parser.getString();
+ if (ignore) {
+ return value;
+ }
+ return XssUtils.filterParam(value);
+ }
+
+ @Override
+ public ValueDeserializer createContextual(DeserializationContext context, BeanProperty property) throws JacksonException {
+ if (Objects.nonNull(property) && Objects.nonNull(property.getAnnotation(IgnoreXss.class))) {
+ return new XssStringDeserializer(true);
+ }
+ return new XssStringDeserializer(false);
+ }
+ }
+}
diff --git a/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/LogTrackConfig.java b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/LogTrackConfig.java
new file mode 100644
index 0000000..d94c24f
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/LogTrackConfig.java
@@ -0,0 +1,30 @@
+package xtools.boot.web.base.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Title : LogTrackConfig
+ * Description : LogTrackConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/2/3 15:07
+ */
+@Data
+@Component
+@ConfigurationProperties(prefix = "sys.log.track")
+public class LogTrackConfig {
+
+ /**
+ * 日志追踪忽略路径
+ */
+ private List ignorePath = new ArrayList<>();
+}
diff --git a/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/MvcConverterConfig.java b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/MvcConverterConfig.java
new file mode 100644
index 0000000..a397487
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/config/MvcConverterConfig.java
@@ -0,0 +1,34 @@
+package xtools.boot.web.base.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.convert.converter.Converter;
+import xtools.boot.core.utils.TimeUtils;
+
+import java.time.Instant;
+
+/**
+ * Title : MvcConverterConfig
+ * Description : MvcConverterConfig
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/1/6 14:44
+ */
+@Configuration
+public class MvcConverterConfig {
+
+ /**
+ * 字符串转时间戳
+ *
+ * @return 转换器
+ */
+ @Bean
+ public Converter stringToInstantConverter() {
+ return TimeUtils::toInstant;
+ }
+
+}
diff --git a/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/exception/GlobalControllerExceptionHandler.java b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/exception/GlobalControllerExceptionHandler.java
new file mode 100644
index 0000000..3342df8
--- /dev/null
+++ b/xtools-boot-web/xtools-boot-web-base/src/main/java/xtools/boot/web/base/exception/GlobalControllerExceptionHandler.java
@@ -0,0 +1,238 @@
+package xtools.boot.web.base.exception;
+
+import jakarta.servlet.http.HttpServletRequest;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.converter.HttpMessageNotReadableException;
+import org.springframework.web.HttpRequestMethodNotSupportedException;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.HandlerMethodValidationException;
+import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
+import org.springframework.web.servlet.resource.NoResourceFoundException;
+import xtools.base.config.BaseParams;
+import xtools.boot.api.enums.ResultType;
+import xtools.boot.api.exection.BizError;
+import xtools.boot.api.exection.BizPublicKeyError;
+import xtools.boot.api.exection.BizWarning;
+import xtools.boot.api.exection.UnauthorizedError;
+import xtools.boot.api.model.dto.Result;
+import xtools.boot.api.model.dto.log.LogTrack;
+import xtools.boot.log.LogBus;
+import xtools.boot.log.enums.LogBusBaseType;
+import xtools.boot.log.holder.LogTrackHolder;
+import xtools.core.StringUtils;
+import xtools.core.enums.LogLevel;
+import xtools.core.extend.TemplateUtils;
+
+import java.util.Objects;
+import java.util.StringJoiner;
+
+/**
+ * Title : GlobalExceptionHandler
+ * Description : GlobalExceptionHandler
+ * DevelopTools : Idea_x64_v2026.1
+ * DevelopSystem : macOS Sequoia 15.7.5
+ * Company : org.xujun
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/1/5 15:21
+ */
+@Slf4j
+@RestControllerAdvice
+public class GlobalControllerExceptionHandler implements BaseParams {
+
+ /**
+ * 参数类型不匹配异常模板
+ */
+ private static final String ARGUMENT_TYPE_MISMATCH_TEMPLATE = "参数[{}]类型不匹配";
+
+ /**
+ * 参数类型不匹配
+ *
+ * @param e 参数类型不匹配异常
+ * @param request 请求
+ * @return 错误结果
+ */
+ @ExceptionHandler(MethodArgumentTypeMismatchException.class)
+ public Result