WuEasy通用微服务

主题切换

🚀 快速开始 ​

📖 概述 ​

TIP

本指南将帮助您快速搭建和运行WuEasy框架的示例项目，包括环境准备、数据库配置和服务启动等步骤。

⚙️ 环境准备 ​

1. 获取示例代码 ​

NOTE

示例代码包含完整的项目结构和基础功能实现，可以作为您开发的起点。

📥 下载示例项目源码

2. 导入项目 ​

  1. 使用IDE导入下载的Maven工程
  2. 等待依赖包下载完成
  3. 检查项目结构是否完整

📊 数据库配置 ​

1. 创建测试表 ​

TIP

以下SQL用于创建示例所需的基础表结构

sql
CREATE TABLE `test` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  `created_date` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1;

🔧 修改配置 ​

1. 配置中心设置 ​

NOTE

示例项目默认未启用Nacos配置中心，可根据实际需求开启

在application.yml中配置Nacos：

yaml
spring:
  application:
    name: web #应用名称
  profiles:
    active: ${SPRING_PROFILES_ACTIVE:dev} #环境配置
  cloud: 
    nacos: 
      server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848} #nacos配置地址
      username: ${NACOS_USERNAME:} #Nacos用户名
      password: ${NACOS_PASSWORD:} #Nacos密码
      config: #配置中心配置
        namespace: ${spring.profiles.active} #命名空间
        group: ${NACOS_GROUP:dev}
        file-extension: yaml #文件格式
        enabled: true
      discovery:  #注册中心配置
        namespace: ${spring.profiles.active} #命名空间
        group: ${NACOS_GROUP:dev}
        enabled: true
  config:
    import:
      - optional:nacos:${spring.application.name}.${spring.cloud.nacos.config.file-extension}?refresh=true

2. Redis配置 ​

在application-dev.yml中配置Redis连接：

yaml
  data:
    redis:
      database: 9
      host: 172.25.240.2
      port: 6379
      password: wueasy123321
      timeout: 3000
      lettuce:
        pool:
          max-active: 100
          max-wait: -1
          max-idle: 10
          min-idle: 0

3. 数据库配置 ​

在application-dev.yml中配置数据库连接：

yaml
spring: 
  datasource:
    type: com.zaxxer.hikari.HikariDataSource
    url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai&useSSL=false&useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
    hikari:
      minimum-idle: 5 #池中最小空闲连接数量，默认值10
      idle-timeout: 30000 #一个连接idle状态的最大时长（毫秒），超时则被释放（retired），缺省:10s
      maximum-pool-size: 15 # 池中最大连接数（包括空闲和正在使用的连接）
      auto-commit: true # 是否自动提交池中返回的连接
      pool-name: HikariCP # 连接池的名字
      max-lifetime: 120000 # 连接池中连接的最大生命周期
      connection-timeout: 30000 # 连接超时时间。默认值为30s
      connection-test-query: SELECT 1 # 测试连接

🎯 启动验证 ​

1. 启动前检查 ​

  • ✅ 配置文件参数正确
  • ✅ 数据库服务正常运行
  • ✅ Redis服务正常运行（如果使用）
  • ✅ Nacos服务正常运行（如果启用）

2. 启动服务 ​

  1. 运行项目主类中的main方法
  2. 观察控制台日志输出
  3. 确认服务启动成功

3. 接口验证 ​

  • 测试示例接口
  • 检查响应结果

💡 常见问题 ​

  1. 启动失败

    • 检查配置文件格式
    • 验证数据库连接
    • 确认端口占用情况

  2. 接口访问异常

    • 检查服务状态
    • 验证请求参数
    • 查看错误日志

Copyright © 2017-2025 wueasy.com