.NET 4.8程序调用AWS API遇TLS版本错误及运行版本异常排查

一、先确认应用实际运行的.NET Framework版本 #

从User Agent里的.NET_Runtime/4.0 .NET_Framework/4.0可以确定，你的代码实际运行在.NET Framework 4.0环境，而非目标的4.8，这是核心问题之一，对应排查方向：

• 检查IIS应用程序池配置：打开IIS管理器，找到对应站点的应用程序池，查看.NET CLR版本，确保选择v4.0.30319（.NET 4.8属于v4.x分支，显示为此版本号），避免选无托管代码或旧版本。
• 核对web.config配置：确认<httpRuntime targetFramework="4.8"/>和<compilation targetFramework="4.8"/>都正确设置，没有被意外覆盖为4.0。
• 验证服务器.NET 4.8安装状态：运行命令reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v Release，若返回的Release值≥528040，说明4.8已正确安装；否则重新安装.NET 4.8运行时。

二、显式强制应用使用TLS 1.2 #

注册表默认设置可能因应用或AWS SDK的行为不生效，建议在代码中直接指定TLS版本，确保不依赖系统默认：
在应用启动入口（比如Global.asax的Application_Start方法、Program.cs入口）添加以下代码：

System.Net.ServicePointManager.SecurityProtocol = 
    System.Net.SecurityProtocolType.Tls12 | 
    System.Net.SecurityProtocolType.Tls13; // 可选加入TLS1.3，AWS已支持

注意：不要单独设置Tls12，用按位或保留更高版本兼容性，避免未来AWS调整TLS政策时再次出问题。

三、验证AWS SDK兼容性与执行顺序 #

• 你的AWS SDK版本aws-sdk-dotnet-45/3.7.301.2兼容.NET 4.5+，但如果运行在.NET 4.0环境下会存在兼容性问题，包括默认TLS版本的异常，优先解决运行环境到4.8。
• 确保TLS设置代码在AWS客户端初始化之前执行，否则设置不会生效。可以添加日志验证当前SecurityProtocol值：

var currentProtocol = System.Net.ServicePointManager.SecurityProtocol;
// 将currentProtocol输出到日志，确认是否包含Tls12

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