log4net对接MySQL配置咨询：附AdoNetAppender配置代码片段

针对你给出的log4net配置片段，我整理了关键的配置完善点、依赖检查项和常见问题排查步骤，帮你顺利搭建MySQL日志输出：

1. 补全配置完整性 #

你的commandText明显截断了，首先要确保SQL语句完整，并且每个参数都对应了正确的映射节点。以下是完整的参考配置片段：

<appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
  <bufferSize value="1" />
  <connectionType value="MySql.Data.MySqlClient.MySqlConnection, MySql.Data" />
  <connectionString value="Server=127.0.0.1;Database=logging;Uid=root;Pwd=mysql;" />
  <!-- 完整的INSERT语句 -->
  <commandText value="INSERT INTO log (Date,Thread,Level,Logger,Message,Exception, UserInput) VALUES (?log_date, ?thread, ?log_level, ?logger, ?message, ?exception, ?user_input)" />
  
  <!-- 每个参数的映射配置 -->
  <parameter>
    <parameterName value="?log_date" />
    <dbType value="DateTime" />
    <layout type="log4net.Layout.RawTimeStampLayout" />
  </parameter>
  <parameter>
    <parameterName value="?thread" />
    <dbType value="String" />
    <size value="255" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%thread" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="?log_level" />
    <dbType value="String" />
    <size value="50" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%level" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="?logger" />
    <dbType value="String" />
    <size value="255" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%logger" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="?message" />
    <dbType value="String" />
    <size value="4000" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%message" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="?exception" />
    <dbType value="String" />
    <size value="4000" />
    <layout type="log4net.Layout.ExceptionLayout" />
  </parameter>
  <parameter>
    <parameterName value="?user_input" />
    <dbType value="String" />
    <size value="4000" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%property{UserInput}" />
    </layout>
  </parameter>
</appender>

注意：UserInput是自定义属性，需要在代码中通过log4net.ThreadContext.Properties["UserInput"] = "你的输入内容";主动设置，否则会插入空值到数据库。

2. 依赖与版本检查 #

• 确保项目已安装MySql.Data NuGet包，版本要和connectionType中的程序集名称匹配。如果使用的是MySQLConnector包（更轻量化的MySQL驱动），需要把connectionType改为MySqlConnector.MySqlConnection, MySqlConnector。
• 建议使用log4net的稳定版（比如2.0.15+），避免旧版本和MySQL驱动的兼容性问题。

3. 连接字符串与数据库验证 #

• 检查连接字符串中的Server、Database、Uid、Pwd是否正确：本地测试时确认MySQL服务正在运行，若修改过默认端口，需添加Port=xxx;参数。
• 可以写一段简单的测试代码，用相同的连接字符串尝试连接MySQL，确认能正常访问logging数据库，避免权限或网络问题。

4. 数据库表结构匹配 #

确保log表的字段类型和配置中的dbType对应：

• Date字段应为DATETIME或TIMESTAMP类型；
• Thread、Level、Logger建议用VARCHAR类型，长度和配置中的size保持一致；
• Message、Exception、UserInput推荐用TEXT或VARCHAR(4000)（根据实际日志长度调整）；
• 注意MySQL的大小写敏感性：Windows系统默认不区分字段名大小写，Linux系统默认区分，尽量保持SQL中的字段名和数据库表字段名完全一致。

5. 调试与问题排查技巧 #

• 开启log4net内部调试，能帮你快速定位配置加载、连接或SQL执行错误。在App.config/Web.config中添加以下配置：

<appSettings>
  <add key="log4net.Internal.Debug" value="true" />
</appSettings>
<system.diagnostics>
  <trace autoflush="true">
    <listeners>
      <add name="textWriterTraceListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="log4net_debug.log" />
    </listeners>
  </trace>
</system.diagnostics>

生成的log4net_debug.log会记录所有内部细节，是排查问题的核心依据。

• 你的bufferSize="1"设置会让每条日志立即写入数据库，适合调试；生产环境可以适当调大（比如100）提升性能，但要注意应用崩溃时可能丢失未写入的日志。

6. 常见问题处理 #

• 日志不写入数据库：优先查看log4net_debug.log，是否有连接失败、SQL语法错误或权限不足的提示；
• 权限问题：确认数据库用户root拥有logging.log表的INSERT权限；
• 参数顺序问题：部分MySQL驱动对参数顺序敏感，确保parameter节点的顺序和SQL中参数的顺序一致；
• 乱码问题：将数据库表的编码设置为utf8mb4，支持全字符集，避免特殊字符导致的插入失败或乱码。

内容的提问来源于stack exchange，提问作者Pacman