ASP.NET Core 5应用从Windows迁移至Linux后出现InvalidCastException报错

第一优先级：校验EF Core列类型映射配置 #

• 优先核对所有实体类属性与SQL Azure列的类型匹配规则，Windows环境下SQL Server驱动默认对非严格匹配的类型有隐式兼容逻辑，Linux下的Microsoft.Data.SqlClient驱动默认类型校验更严格，不会自动执行宽范围隐式转换：
  • 确认实体中声明为string类型的属性，对应SQL Azure列确实为varchar/nvarchar类型，而非int、uniqueidentifier类型
  • 检查是否存在实体属性用[Column(TypeName = "...")]标注了Windows特有类型别名，或是Fluent API配置中写入了仅Windows环境兼容的类型描述
  • 如果使用EF Core逆向工程生成实体，确认生成规则是否基于Windows环境schema，遗漏了Linux下驱动要求的显式类型映射

第二优先级：检查大小写敏感配置 #

• Linux系统本身大小写敏感，若SQL Azure排序规则为大小写不敏感，但EF Core模型配置开启了大小写敏感匹配，会出现列名/表名映射错误，导致查询返回的字段顺序、类型和实体预期不匹配，触发类型转换异常：
  • 检查OnModelCreating方法中UseCollation相关配置，确认和SQL Azure实际排序规则一致
  • 确认实体类属性名、配置的列名和SQL Azure实际列名大小写完全匹配，不要依赖Windows环境下的大小写不敏感容错

第三优先级：校验SqlClient驱动版本及运行时配置 #

• 确认部署到Linux环境的应用包里Microsoft.Data.SqlClient版本和Windows环境使用版本完全一致，低版本SqlClient在Linux下存在已知类型映射缺陷
• 检查SQL Server连接字符串的特殊参数配置：
  • 不要添加Windows特有参数如Integrated Security=true，Linux下不支持Windows身份验证
  • 可尝试在连接字符串中添加Type System Version=Latest，强制驱动使用统一的类型解析规则
  • 确认连接字符串中TrustServerCertificate参数配置正确，Linux下默认不会信任SQL Azure证书，证书错误有时会导致返回数据包解析异常，间接触发类型转换错误

第四优先级：排查可空类型配置 #

• 若项目开启了C#可空引用类型，检查EF Core可空配置是否符合Linux环境要求：
  • EF Core 5在Linux下对可空引用类型的校验比Windows下更严格，如果实体属性声明为不可空string，但数据库列允许为NULL，查询返回NULL时就会触发SqlNullValueException
  • 确认所有实体的可空声明和数据库列的NULL/NOT NULL约束完全对应，不要依赖Windows环境下的静默兼容

快速验证方法 #

• 本地用WSL启动Linux环境运行应用，连接同一SQL Azure实例，复现问题后调试查看EF Core生成的SQL语句，以及返回结果的实际类型，可快速定位具体出错的实体属性映射
• 开启EF Core详细日志：optionsBuilder.LogTo(Console.WriteLine, LogLevel.Debug)，查看查询执行时的类型转换日志，定位出错的具体映射规则

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