GCP Buildpack部署.NET项目失败：无法识别runtimeconfig.json运行时版本

问题描述 #

使用GCP Buildpack部署测试项目，尽管通过.csproj中设置GenerateRuntimeConfiguration=true自动生成的runtimeconfig.json已明确定义运行时版本，但部署仍失败，构建日志提示无法从runtimeconfig.json中找到运行时版本。

构建日志 #

Step #0 - "Buildpack":   cat /workspace/bin/TestServerConsole.runtimeconfig.json
Step #0 - "Buildpack":   {
Step #0 - "Buildpack":     "runtimeOptions": {
Step #0 - "Buildpack":       "tfm": "net6.0",
Step #0 - "Buildpack":       "framework": {
Step #0 - "Buildpack":         "name": "Microsoft.NETCore.App",
Step #0 - "Buildpack":         "version": "6.0.0"
Step #0 - "Buildpack":       },
Step #0 - "Buildpack":       "configProperties": {
Step #0 - "Buildpack":         "System.Reflection.Metadata.MetadataUpdater.IsSupported": false
Step #0 - "Buildpack":       }
Step #0 - "Buildpack":     }
Step #0 - "Buildpack":   }
Step #0 - "Buildpack": Done "dotnet publish -nologo --verbosity minimal --configuration R..." (7.695605258s)
Step #0 - "Buildpack": 正在从输出目录bin和项目文件TestServerConsole/TestServerConsole.csproj确定入口点
Step #0 - "Buildpack": === .NET - Runtime (google.dotnet.runtime@0.9.1) ===
Step #0 - "Buildpack": 找到runtimeconfig.json文件：TestServerConsole/bin/Release/net6.0/TestServerConsole.runtimeconfig.json
Step #0 - "Buildpack": 使用runtimeconfig文件"TestServerConsole/bin/Release/net6.0/TestServerConsole.runtimeconfig.json"
Step #0 - "Buildpack": 失败：（ID：224c5ea3）无法运行/bin/build：无法从runtimeconfig.json中找到运行时版本：&dotnet.RuntimeConfigJSON{RuntimeOptions:dotnet.runtimeOptions{TFM:"net6.0", Framework:dotnet.framework{Name:"Microsoft.NETCore.App", Version:"6.0.0"}, Frameworks:[]dotnet.framework(nil), ConfigProperties:dotnet.configProperties{SystemGCServer:false}}}
Step #0 - "Buildpack": --------------------------------------------------------------------------------
Step #0 - "Buildpack": 抱歉，您的项目构建失败。

解决方法 #

• 指定目标运行时发布：在dotnet publish命令中添加--runtime linux-x64参数，适配GCP Buildpack的Linux运行环境，明确指定运行时可避免版本识别偏差。修改后的发布命令示例：

  dotnet publish -c Release --runtime linux-x64 --self-contained false
  

• 升级Buildpack版本：日志中使用的google.dotnet.runtime@0.9.1版本较旧，部署时指定最新的GCP Buildpack builder版本，可修复旧版本的解析bug。
• 调整runtimeconfig.json版本格式：将framework.version从6.0.0改为6.0，部分旧版Buildpack对精确版本号的解析存在问题，修改后的片段如下：

  "framework": {
    "name": "Microsoft.NETCore.App",
    "version": "6.0"
  }
  

• 核对项目配置：确认.csproj中<TargetFramework>net6.0</TargetFramework>配置正确，同时确保GenerateRuntimeConfigurationFiles=true已正确设置。

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