refactor(Logger): 优化日志配置和MongoDB相关属性命名

- 重命名MongoDB相关属性以增加一致性
- 提取日志输出模板为常量
- 改进日志路径处理逻辑
- 优化属性初始化方式
- 更新XML文档注释以提供更详细的MongoDB连接说明

Author: AlianBlank

GameFrameX.Foundation.Logger/LogHandler.cs

@@ -18,7 +18,7 @@ namespace GameFrameX.Foundation.Logger;
 /// </summary>
 public static class LogHandler
 {
-    private static bool _isInitSerilogDiagnosis = false;
+    private static bool _isInitSerilogDiagnosis;
 
     /// <summary>
     /// 启用 Serilog 的自动诊断
@@ -54,6 +54,16 @@ public static LoggerConfiguration CreateLoggerConfiguration()
                .MinimumLevel.Override("Microsoft.AspNetCore", LogEventLevel.Warning);
     }
 
+    /// <summary>
+    /// 控制台输出模板，用于格式化控制台日志输出。
+    /// </summary>
+    const string ConsoleOutputTemplate = "[{Timestamp:HH:mm:ss} {Level:u3}][{LogType}-{TagName}]{Message:lj}{NewLine}{Exception}";
+
+    /// <summary>
+    /// 文件输出模板，用于格式化文件日志输出。
+    /// </summary>
+    const string FileOutputTemplate = "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}][{LogType}-{TagName}] {Message:lj}{NewLine}{Exception}";
+
     /// <summary>
     /// 启动并配置日志系统
     /// </summary>
@@ -68,9 +78,20 @@ public static ILogger Create(LogOptions logOptions, bool isDefault = true, Actio
         SerilogDiagnosis();
         try
         {
-            // 日志文件存储的路径
+            // 文件名
             var logFileName = $"{(logOptions.LogType ?? AppDomain.CurrentDomain.FriendlyName).ToLower()}_.log";
+            // 日志文件存储的路径
             var logSavePath = logOptions.LogSavePath ?? "./logs/";
+            if (!logSavePath.EndsWithFast("/"))
+            {
+                logSavePath += "/";
+            }
+
+            if (!string.IsNullOrEmpty(logOptions.LogTagName))
+            {
+                logSavePath += logOptions.LogTagName + "/";
+            }
+
             // 计算最终日志文件路径
             var logPath = Path.Combine(logSavePath, logFileName);
             // 兼容可能的层级目录：始终创建文件所在的目录
@@ -80,23 +101,15 @@ public static ILogger Create(LogOptions logOptions, bool isDefault = true, Actio
                 Directory.CreateDirectory(logFolderPath);
             }
 
-
-            // Console.WriteLine("the following is the log configuration information");
             if (isDefault)
             {
                 LogHelper.ShowOption("log configuration information", logOptions);
             }
 
-            // Console.WriteLine("╔═════════════════════════════════════════════════════════╗");
-            // Console.WriteLine(logOptions);
-            // Console.WriteLine("╚═════════════════════════════════════════════════════════╝");
-            Console.WriteLine();
-            var logger = CreateLoggerConfiguration().Enrich.WithProperty("AppType", logOptions.LogType ?? AppDomain.CurrentDomain.FriendlyName);
-            if (!string.IsNullOrEmpty(logOptions.LogTagName))
-            {
-                logger.Enrich.WithProperty("TagName", logOptions.LogTagName ?? "");
-            }
-
+            var logger = CreateLoggerConfiguration();
+            logger.Enrich.WithProperty("LogType", logOptions.LogType);
+            logger.Enrich.WithProperty("FriendlyName", AppDomain.CurrentDomain.FriendlyName);
+            logger.Enrich.WithProperty("TagName", logOptions.LogTagName ?? "");
 
             if (logOptions.IsGrafanaLoki)
             {
@@ -156,15 +169,14 @@ public static ILogger Create(LogOptions logOptions, bool isDefault = true, Actio
             }
 
             configurationAction?.Invoke(logger);
-
-            string consoleOutputTemplate = "[{Timestamp:HH:mm:ss} {Level:u3}][{TagName}]{Message:lj}{NewLine}{Exception}";
-            string fileOutputTemplate = "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}][{FriendlyName}] {Message:lj}{NewLine}{Exception}";
+            string consoleOutputTemplate = ConsoleOutputTemplate;
 
             if (logOptions.ConsoleOutputTemplate.IsNotNullOrEmptyOrWhiteSpace())
             {
                 consoleOutputTemplate = logOptions.ConsoleOutputTemplate;
             }
 
+            string fileOutputTemplate = FileOutputTemplate;
             if (logOptions.FileOutputTemplate.IsNotNullOrEmptyOrWhiteSpace())
             {
                 fileOutputTemplate = logOptions.FileOutputTemplate;
@@ -225,15 +237,15 @@ public static ILogger Create(LogOptions logOptions, bool isDefault = true, Actio
             var serilog = logger.CreateLogger();
             if (isDefault)
             {
-                Serilog.Log.Logger = serilog;
+                Log.Logger = serilog;
                 LogHelper.SetLogger(serilog);
             }
 
             return serilog;
         }
         catch (Exception e)
         {
-            Serilog.Log.Error($"配置日志系统过程中发生错误,异常:{e}");
+            Log.Error($"配置日志系统过程中发生错误,异常:{e}");
             throw;
         }
     }

GameFrameX.Foundation.Logger/LogOptions.cs

@@ -61,22 +61,41 @@ public LogOptions(string logPathName = "logs")
     public bool IsWriteToMongoDb { get; set; } = false;
 
     /// <summary>
-    /// mongodb 地址 用于保存日志
+    /// MongoDB 数据库连接地址，用于保存日志数据
     /// </summary>
     /// <remarks>
-    /// 如果配置了Type = Db 必须要配置 databaseUrl
+    /// <para>
+    /// 当 <see cref="IsWriteToMongoDb"/> 设置为 true 时，此属性必须配置有效的 MongoDB 连接字符串。
+    /// 连接字符串应包含数据库服务器地址、端口、数据库名称和认证信息。
+    /// </para>
+    /// <para>
+    /// 连接字符串格式：mongodb://[username:password@]host[:port]/database[?options]
+    /// </para>
+    /// <para>
+    /// 常用配置示例：
+    /// <list type="bullet">
+    /// <item><description>本地无认证：mongodb://localhost:27017/gameserver</description></item>
+    /// <item><description>本地有认证：mongodb://user:password@localhost:27017/gameserver?authSource=admin</description></item>
+    /// <item><description>远程服务器：mongodb://user:password@192.168.1.100:27017/gameserver?authSource=admin</description></item>
+    /// <item><description>副本集：mongodb://user:password@host1:27017,host2:27017/gameserver?replicaSet=rs0&amp;authSource=admin</description></item>
+    /// </list>
+    /// </para>
+    /// <para>
+    /// 注意：确保 MongoDB 服务器已启动且网络连接正常，否则日志写入将失败。
+    /// </para>
     /// </remarks>
-    public string DatabaseUrl { get; set; } = "mongodb://127.0.0.1:27017/gameserver?authSource=admin";
+    /// <value>默认值为本地 MongoDB 实例：mongodb://127.0.0.1:27017/gameserver?authSource=admin</value>
+    public string MongoDbDatabaseUrl { get; set; } = "mongodb://127.0.0.1:27017/gameserver?authSource=admin";
 
     /// <summary>
     /// mongodb 创建的上限集合的最大总大小（MB）
     /// </summary>
-    public int CappedMaxSizeMb { get; set; } = 50;
+    public int MongoDbCappedMaxSizeMb { get; set; } = 50;
 
     /// <summary>
     /// mongodb 创建的上限集合的最大文档数。
     /// </summary>
-    public int CappedMaxDocuments { get; set; } = 50000;
+    public int MongoDbCappedMaxDocuments { get; set; } = 50000;
 
     /// <summary>
     /// 日志存储路径，为 应用程序运行目录下的子目录/logs。
@@ -174,7 +193,6 @@ public LogOptions(string logPathName = "logs")
     /// </remarks>
     public int? RetainedFileCountLimit { get; set; } = 31;
 
-
     /// <summary>
     /// 控制台日志输出格式模板，默认格式为 "[时:分:秒 级别][标签名]消息内容"。
     /// </summary>