Github Codespaces中Dotnet应用端口转发与路径配置问题

问题情况 #

在 GitHub Codespaces 里运行 .NET 应用时，启动后浏览器打开的 URL 为 https://[redacted]-8081.app.github.dev:8081，存在两个问题：

1. 未自动追加 launch.json 中定义的 /graphql 路径，直接访问返回 404；
2. 手动添加 /graphql 后，带 -8081 子域名的 URL 仍无法正常响应，但无 -8081 子域名的 https://[redacted].app.github.dev:8081/graphql/ 可正常访问。

问题1：配置 VS Code 自动追加 /graphql 路径 #

直接修改 .vscode/launch.json 中的 serverReadyAction 配置，适配 Codespaces 的 URL 格式，确保能正确追加路径：

{
    "name": "C#: ASPNetCoreWebAPI Debug",
    "type": "coreclr",
    "request": "launch",
    "preLaunchTask": "build backend",
    "program": "${workspaceFolder}/ASPNETCoreWebAPI/bin/Debug/net8.0/ASPNETCoreWebAPI.dll",
    "cwd": "${workspaceFolder}/ASPNETCoreWebAPI",
    "serverReadyAction": {
        "action": "openExternally",
        // 修改匹配模式，覆盖 Codespaces 可能把端口嵌在子域名里的 URL 格式
        "pattern": "\\bNow listening on:\\s+(https?://\\S+)|\\bApplication started. Press Ctrl\\+C to shut down.",
        // 确保替换后自动加上/graphql路径
        "uriFormat": "%s/graphql/"
    }, 
    "env": {
        "ASPNETCORE_ENVIRONMENT": "Development"
    }
}

如果上述匹配模式不生效，直接用 Codespaces 环境变量拼接完整 URL：

"serverReadyAction": {
    "action": "openExternally",
    "uriFormat": "https://${localEnv:CODESPACE_NAME}.app.github.dev:8081/graphql/"
}

问题2：二选一解决子域名 -8081 问题 #

方案A：让 VS Code/DevContainer 不在子域名中包含 -8081 #

修改 .devcontainer/devcontainer.json，添加配置禁用端口号附加到子域名：

{
    "forwardPorts": [8081],
    "portsAttributes": {
        "8081": {
            "protocol": "https",
            "visibility": "private",
            "onAutoForward": "notify",
            // 添加此属性，阻止端口号被加到子域名里
            "localPort": 8081,
            "requirePortForward": true
        }
    },
    "publishAllPorts": false
}

修改完成后重启 Codespaces 容器，配置即可生效。

方案B：让应用支持带 -8081 的子域名访问 #

给 .NET 应用添加两项配置：

1. 在 Program.cs 中配置 CORS（如果有跨域需求）：

builder.Services.AddCors(options =>
{
    options.AddPolicy("AllowCodespacesSubdomain",
        policy => policy.WithOrigins("https://[redacted]-8081.app.github.dev")
                        .AllowAnyHeader()
                        .AllowAnyMethod());
});

app.UseCors("AllowCodespacesSubdomain");

2. 允许应用绑定所有主机（开发环境下适用）：
   在 Program.cs 中添加一行代码：

app.Urls.Add("https://*:8081");

或者直接修改 Properties/launchSettings.json 的 applicationUrl：

"applicationUrl": "https://*:8081",

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