Visual Studio 2019添加Azure Function至Docker Compose构建失败问题

Let's break down what's happening here and how to fix it:

Root Cause #

The error CTC1031 Linux containers are not supported for Func project stems from a limitation in the Visual Studio 2019 16.7.x Docker Compose tooling.

Visual Studio's Microsoft.VisualStudio.Docker.Compose.targets file includes validation logic that checks if each project in your docker-compose setup supports the selected container type (Linux in your case). For Azure Functions projects, this validation logic hadn't been updated in VS 16.7.x to recognize that Functions do support Linux containers, triggering the false error.

The reason docker-compose -f docker-compose.yml up works from the command line is that it bypasses Visual Studio's internal validation entirely—it communicates directly with the Docker engine, which has no issue running the Functions container.

Fixes & Workarounds #

1. Upgrade Visual Studio 2019 (Recommended) #

Microsoft fixed this compatibility issue in Visual Studio 2019 version 16.8 and later. Upgrading to the latest available 16.x release will resolve the validation error, letting you build and debug the docker-compose setup directly from VS without any workarounds.

2. Bypass VS's Project Validation (Temporary Workaround) #

If you can't upgrade VS right now, you can disable the validation check for the docker-compose project:

1. Open your docker-compose project file (the .dcproj file) in a text editor.
2. Add the following property group inside the <Project> element:

   <PropertyGroup>
     <DockerComposeSkipProjectValidation>True</DockerComposeSkipProjectValidation>
   </PropertyGroup>
   

3. Save the file and reload the solution in VS.

This tells Visual Studio to skip checking whether each project supports the selected container type, allowing the build to complete successfully. Note this is a temporary fix—upgrading VS is the better long-term solution to avoid other potential tooling issues.

3. Manual Build & Debug #

You can keep using the command line to start your containers with docker-compose up, then attach Visual Studio's debugger to the running Functions container:

1. Run docker-compose up to start both services.
2. In VS, go to Debug > Attach to Process.
3. Select the Docker (Linux) option from the connection type dropdown, then pick your running Func container and attach the debugger.

This lets you debug the Functions app without relying on VS's docker-compose build pipeline.

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