如何本地运行Release模式编译的ASP.NET Core HTTPS网站并解决会话Cookie解密异常

这个问题核心涉及本地HTTPS证书有效性和DataProtection密钥一致性两个关键环节，下面是具体的解决步骤：

1. 配置可信任的本地HTTPS证书 #

Release模式下不会像Debug那样由Visual Studio自动配置HTTPS证书，你需要手动生成并信任本地开发证书：

• 打开PowerShell或命令提示符，执行以下命令清理旧证书并生成新的可信证书：

  dotnet dev-certs https --clean
  dotnet dev-certs https --trust
  

  执行过程中如果弹出信任确认窗口，选择"是"完成证书信任配置。

2. 统一DataProtection密钥存储（解决Session Cookie解密失败） #

你的异常日志显示Error unprotecting the session cookie，本质是Debug和Release模式默认使用不同的DataProtection密钥存储位置，导致Release环境无法解密Debug环境生成的Session数据。

你可以在Program.cs中配置统一的密钥存储路径，让不同环境共享密钥上下文：

builder.Services.AddDataProtection()
    .PersistKeysToFileSystem(new DirectoryInfo(@"C:\Your\Custom\Key\Directory")) // 替换为你本地的稳定目录
    .SetApplicationName("YourApplicationName"); // 设置固定的应用名称，确保密钥上下文一致

注意：请确保指定的目录已创建，且运行网站的用户拥有该目录的读写权限。

3. 清理旧Session Cookie #

之前Debug模式生成的Session Cookie是用Debug环境密钥加密的，Release环境无法解密，访问网站前请手动清理浏览器中localhost相关的Cookie。

4. 验证Release运行配置 #

运行Release版可执行文件时，可明确指定HTTPS端口确保匹配：

YourAppRelease.exe --urls "https://localhost:5001"

或者在appsettings.json中配置Kestrel端点：

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://localhost:5001"
      }
    }
  }
}

完成以上操作后，重新启动Release版程序，就能正常通过https://localhost:5001/访问网站了。

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