Visual Studio本地与Docker构建时.proto文件引用差异问题排查

背景 #

手里有A.proto、B.proto和common.proto三个文件，A和B都要导入common.proto。原先所有proto在同一文件夹，通过VS Mac的文件链接方式加入项目，项目配置如下：

<ItemGroup>
  <Protobuf Include="../Protos/common.proto" GrpcServices="Server">
    <Link>Protos\common.proto</Link>
  </Protobuf>
  <Protobuf Include="../Protos/A.proto" GrpcServices="Server">
    <Link>Protos\A.proto</Link>
  </Protobuf>
  <Protobuf Include="../Protos/B.proto" GrpcServices="Server">
    <Link>Protos\B.proto</Link>
  </Protobuf>
</ItemGroup>

proto文件中引用common.proto的语句为：

import "Common.proto";

VS中构建、生成C#类、运行都正常，但自行编写Dockerfile构建时出现报错。

Docker构建报错情况 #

当前应用文件夹结构：

src
 |- Dockerfile
 |-Project1
     |-project1.csproj
     |- Protos
         |-common.proto
         |-A.proto
         |-B.proto

Docker可完成文件复制和依赖还原，但构建时提示：Could not make proto path relative : error : ../Protos/common.proto:...。项目环境为.NET 7，Grpc.AspNetCore与Grpc.Tools版本均为2.54.0。

已尝试的无效方案 #

• 修改A/B的导入语句为import "Protos/Common.proto"，并在项目文件中添加AdditionalImportDirs="Protos"，但VS提示common.proto中的对象重复
• 将Protos文件夹移至项目同级目录并更新Dockerfile，问题依旧存在
• 仅在A.proto中导入common.proto，B.proto导入A.proto，导致VS中B.proto无法找到common.proto的消息

问题根源 #

1. VS链接文件的虚拟路径差异：VS通过<Link>标签展示虚拟的Protos目录，构建时能识别原文件的../Protos/相对路径；但Docker构建时工作目录为src/Project1/，此时../Protos/指向src/Protos/，与实际存放路径src/Project1/Protos/完全不符。
2. 大小写敏感校验差异：Mac系统本身大小写敏感，你使用import "Common.proto"但实际文件名为common.proto，VS可能因配置忽略了大小写差异，但Docker中GRPC工具会严格校验文件名大小写，直接导致路径解析失败。

解决办法 #

1. 修正项目配置与导入语句 #

• 保留当前Docker中的文件夹结构（所有proto文件位于src/Project1/Protos/）
• 修改项目文件的Protobuf配置，直接引用项目内的文件，移除外部路径与<Link>标签：

  <ItemGroup>
    <Protobuf Include="Protos/common.proto" GrpcServices="Server" />
    <Protobuf Include="Protos/A.proto" GrpcServices="Server" />
    <Protobuf Include="Protos/B.proto" GrpcServices="Server" />
  </ItemGroup>
  

• 将A.proto与B.proto中的导入语句改为小写的相对路径（三个文件在同一目录，直接写文件名即可）：

  import "common.proto";
  

  无需配置AdditionalImportDirs，同一目录下GRPC工具会自动识别依赖。

2. 调整Dockerfile的工作目录 #

确保Docker构建时的工作目录为项目根目录，示例Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["Project1/Project1.csproj", "Project1/"]
RUN dotnet restore "Project1/Project1.csproj"
COPY . .
WORKDIR "/src/Project1"  # 关键：切换到项目根目录执行构建
RUN dotnet build "Project1.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Project1.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "Project1.dll"]

3. 清理冗余配置 #

删除之前添加的AdditionalImportDirs配置，避免因重复生成代码导致的类重复错误。

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