feat: 添加微服务模板基础架构

- 创建基于 CloudWego Hertz 的 Go 微服务脚手架
- 集成 Nacos 服务注册/发现功能
- 添加 gRPC 客户端支持
- 实现环境变量配置管理 (.env.example)
- 添加 HTTP 中间件 (Recovery, AccessLog, CORS)
- 配置 Gitea CI/CD 构建部署流程

BREAKING CHANGE: 项目结构调整，从简单的 API 服务升级为完整的微服务架构

utils/nacos/service.go

@@ -1,29 +1,39 @@
 package nacos
 
 import (
+	"errors"
+	"os"
+	"strconv"
+	"sync"
+
 	"github.com/nacos-group/nacos-sdk-go/v2/clients"
 	"github.com/nacos-group/nacos-sdk-go/v2/clients/naming_client"
 	"github.com/nacos-group/nacos-sdk-go/v2/model"
 	"github.com/nacos-group/nacos-sdk-go/v2/vo"
-	"os"
-	"strconv"
 )
 
 var (
-	cli            naming_client.INamingClient
-	groupName      string
-	ServerUriCache = make(map[string]model.Instance)
+	namingClient naming_client.INamingClient
+	namingMu     sync.Mutex
+	groupName    string
+	serviceCache sync.Map
 )
 
-// NewNacosRegistry 创建一个nacos注册中心
-func NewNacosRegistry() (*naming_client.INamingClient, error) {
-	InitNacosRegistryConfig()
-	if cli != nil {
-		return &cli, nil
+func NewNacosRegistry() (naming_client.INamingClient, error) {
+	namingMu.Lock()
+	defer namingMu.Unlock()
+
+	if namingClient != nil {
+		return namingClient, nil
 	}
+
+	if err := InitNacosRegistryConfig(); err != nil {
+		return nil, err
+	}
+
 	groupName = os.Getenv("NACOS_GROUP_NAME")
 	var err error
-	cli, err = clients.NewNamingClient(
+	namingClient, err = clients.NewNamingClient(
 		vo.NacosClientParam{
 			ClientConfig:  cc,
 			ServerConfigs: sc,
@@ -32,17 +42,21 @@ func NewNacosRegistry() (*naming_client.INamingClient, error) {
 	if err != nil {
 		return nil, err
 	}
-	return &cli, nil
+	return namingClient, nil
 }
 
-// RegisterService 注册当前服务到nacos中
 func RegisterService() error {
 	client, err := NewNacosRegistry()
 	if err != nil {
 		return err
 	}
+
 	serviceName := os.Getenv("NACOS_SERVICE_NAME")
 	host := os.Getenv("NACOS_SERVICE_HOST")
+	if serviceName == "" || host == "" {
+		return errors.New("NACOS_SERVICE_NAME 和 NACOS_SERVICE_HOST 必须配置")
+	}
+
 	port, err := strconv.Atoi(os.Getenv("NACOS_SERVICE_PORT"))
 	if err != nil {
 		port = 8848
@@ -51,7 +65,8 @@ func RegisterService() error {
 	if err != nil {
 		weight = 10
 	}
-	_, err = (*client).RegisterInstance(vo.RegisterInstanceParam{
+
+	_, err = client.RegisterInstance(vo.RegisterInstanceParam{
 		Ip:          host,
 		Port:        uint64(port),
 		ServiceName: serviceName,
@@ -61,43 +76,50 @@ func RegisterService() error {
 		Ephemeral:   false,
 		GroupName:   groupName,
 	})
-	if err != nil {
-		return err
-	}
-	return nil
+	return err
 }
 
-// DiscoverServiceList 发现服务列表
 func DiscoverServiceList(serviceName string) ([]model.Instance, error) {
 	client, err := NewNacosRegistry()
 	if err != nil {
 		return nil, err
 	}
-	instances, err := (*client).SelectInstances(vo.SelectInstancesParam{
+	return client.SelectInstances(vo.SelectInstancesParam{
 		ServiceName: serviceName,
 		HealthyOnly: false,
 		GroupName:   groupName,
 	})
-	if err != nil {
-		return nil, err
-	}
-	return instances, nil
 }
 
-// DiscoverService 发现一个服务
 func DiscoverService(serviceName string) (model.Instance, error) {
-	ServiceCache := ServerUriCache[serviceName]
+	if cached, ok := serviceCache.Load(serviceName); ok {
+		cachedInstance := cached.(model.Instance)
+		client, err := NewNacosRegistry()
+		if err != nil {
+			return cachedInstance, err
+		}
+		instance, err := client.SelectOneHealthyInstance(vo.SelectOneHealthInstanceParam{
+			ServiceName: serviceName,
+			GroupName:   groupName,
+		})
+		if err != nil {
+			return cachedInstance, err
+		}
+		serviceCache.Store(serviceName, *instance)
+		return *instance, nil
+	}
+
 	client, err := NewNacosRegistry()
 	if err != nil {
-		return ServiceCache, err
+		return model.Instance{}, err
 	}
-	instances, err := (*client).SelectOneHealthyInstance(vo.SelectOneHealthInstanceParam{
+	instance, err := client.SelectOneHealthyInstance(vo.SelectOneHealthInstanceParam{
 		ServiceName: serviceName,
 		GroupName:   groupName,
 	})
 	if err != nil {
-		return ServiceCache, err
+		return model.Instance{}, err
 	}
-	ServerUriCache[serviceName] = *instances
-	return *instances, nil
+	serviceCache.Store(serviceName, *instance)
+	return *instance, nil
 }