AWS Elastic Beanstalk上.NET API随机报MySQL列不存在异常求助

1. 数据库连接池/连接复用异常 #

• 确认DbContext的生命周期配置：必须是Scoped而非Singleton，Singleton会导致连接长期持有，若数据库出现临时schema变更（比如主从同步、节点维护），旧连接的元数据缓存会和实际库表结构脱节。
• 检查Pomelo连接字符串参数：如果开启了Connection Reset=false，复用连接时会跳过服务器端的连接重置，容易引发元数据不一致。建议显式设置Connection Reset=true。

2. MySQL集群主从切换/同步延迟 #

• 核实Elastic Beanstalk关联的数据库是否为读写分离或自动故障转移集群：故障发生时可能刚好遇到主库切换，新主库的schema同步存在延迟，或者连接被路由到了未同步的从库。
• 查看故障时段的MySQL集群日志：排查是否有主从切换、节点重启或同步延迟的记录。

3. EF Core元数据缓存混乱 #

• 检查代码中是否存在动态修改实体模型的逻辑：比如运行时通过ModelBuilder增改字段，这种操作会打乱元数据缓存，导致随机生成错误SQL。
• 可临时禁用元数据缓存测试（生产环境不建议长期使用）：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      optionsBuilder.UseMySQL(connectionString, b => b.MigrationsAssembly("YourAssembly"))
                    .EnableSensitiveDataLogging();
      // 替换缓存键工厂，每次创建新模型
      optionsBuilder.ReplaceService<IModelCacheKeyFactory, CustomModelCacheKeyFactory>();
  }
  
  public class CustomModelCacheKeyFactory : IModelCacheKeyFactory
  {
      public object Create(DbContext context) => new object();
  }
  

  如果故障不再出现，说明根源是元数据缓存问题。

4. Elastic Beanstalk环境配置差异 #

• 对比故障API环境和正常Portal环境的细节：
  • 实例类型、操作系统、.NET运行时版本是否完全一致；
  • Pomelo.EntityFrameworkCore.MySQL的版本（包括补丁号）是否相同；
  • 环境变量中的数据库连接字符串参数：比如SslMode、AllowPublicKeyRetrieval、CharacterSet等是否有差异。

5. 事务/临时表引发的Schema异常 #

• 检查故障触发的业务逻辑：是否涉及临时表创建或跨事务的Schema操作？这类操作可能导致后续连接的元数据读取异常。
• 开启EF Core敏感日志：通过EnableSensitiveDataLogging()记录故障发生时生成的SQL，确认字段名是否存在大小写错误（MySQL在不同系统下的大小写敏感配置不同）。

6. 连接中断后的重连元数据问题 #

• 检查Pomelo的重试逻辑配置：确保正确设置了连接重试，且重连后会重新获取最新的Schema元数据：

  optionsBuilder.UseMySQL(connectionString, b => b
      .RetryLogic(r => r
          .EnableRetryOnFailure()
          .MaxRetryCount(5)));
  

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