Docker构建.NET5应用报CS1514错误的排查与解决方法

报错Enum.cs(3,27): error CS1514: { expected的核心诱因是代码用了文件范围命名空间语法：你写的namespace App.Enums;是C# 10才加入的特性，不需要用大括号把同命名空间下的所有代码包裹起来。

• 本地Windows环境能正常编译，是因为你本地装了.NET 6及以上版本的SDK，构建工具自动使用了更高版本的C#编译器，兼容这个语法
• Docker环境构建失败，是因为你用的构建基础镜像是.NET 5 SDK，它默认绑定C# 9编译器，识别不了这种新的命名空间写法，读到分号后按照C# 9的语法规则，这里本来应该出现左大括号{，所以直接抛错。

二选一即可：

• 方案一（最稳妥，零额外配置）：把命名空间改回C# 9兼容的传统大括号写法，修改后的Enum.cs代码如下：

namespace App.Enums
{
    public enum Enum1
    {   
        Item1 = 0,
        Item2 = 1,
        Item3 = 2,
        Item4 = 3,
        Item5 = 4
    }
}

改完直接重新执行dotnet publish -c Release -o out就能正常构建，不需要改任何Docker配置。

• 方案二（不修改代码，调整构建配置）：
  1. 要么把Dockerfile里的构建阶段基础镜像换成.NET 6及以上版本的SDK镜像，注意如果运行阶段还是用.NET 5运行时需要做兼容性校验，更推荐直接把项目升级到.NET 6/8这类长期支持版本
  2. 要么在项目的.csproj文件的属性组里手动指定语言版本为预览版，让.NET 5的编译器支持C# 10语法，添加配置如下：

  <PropertyGroup>
    <!-- 其他原有配置不动 -->
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

补充提示：.NET 5已经在2022年5月终止官方支持，没有后续安全更新，生产环境建议尽快升级到LTS版本的.NET。

内容的提问来源于stack exchange，提问作者Gustavo Rocha Dias