fix(openapi): 解决操作ID生成和重复问题

- 修正 HandlerName 中的路径分隔符和点，使其在操作ID中有效替换为下划线
- 在生成操作ID时，结合路由组名称前缀，提高ID唯一性和可读性
- 添加对操作ID重复的检测机制，遇重复时自动添加递增后缀避免冲突
- 确保生成的操作ID在整个生成器中唯一，防止运行时错误

Author: ccfish86

fizz.go

@@ -207,7 +207,14 @@ func (g *RouterGroup) Handle(path, method string, infos []OperationOption, handl
 
 		// Set an operation ID if none is provided.
 		if oi.ID == "" {
-			oi.ID = hfunc.HandlerName()
+			handlerName := hfunc.HandlerName()
+			handlerName = strings.ReplaceAll(handlerName, "/", "_")
+			handlerName = strings.ReplaceAll(handlerName, ".", "_")
+			if g.Name != "" {
+				oi.ID = g.Name + "_" + handlerName
+			} else {
+				oi.ID = handlerName
+			}
 		}
 		oi.StatusCode = hfunc.GetDefaultStatusCode()
 		requestMediaType := hfunc.GetRequestMediaType()

openapi/generator.go

@@ -244,8 +244,15 @@ func (g *Generator) AddOperation(path, method, tag, requestMediaType, responseMe
 
 	if info != nil {
 		// Ensure that the provided operation ID is unique.
-		if _, ok := g.operationsIDS[info.ID]; ok {
-			return nil, fmt.Errorf("ID %s is already used by another operation", info.ID)
+		// If duplicate, append suffix to make it unique.
+		baseID := info.ID
+		counter := 0
+		for {
+			if _, ok := g.operationsIDS[info.ID]; !ok {
+				break
+			}
+			counter++
+			info.ID = fmt.Sprintf("%s_%d", baseID, counter)
 		}
 		g.operationsIDS[info.ID] = struct{}{}
 	}