多项目联调必须使用解决方案级“多启动项目”配置，而非修改各项目launchSettings.json；需分项目设置环境变量、避免端口与协议冲突、统一调试配置，并在WebApp中实现服务健康检查重试。
多项目联调必须用“多启动项目”配置，不是改 launchSettings.json
launchSettings.json 是单项目的启动配置文件，它只对当前项目生效。三个项目一起跑时，VS 不会读取每个项目的 launchSettings.json 并自动组合——它根本不会触发多个 profile 的并发启动。真正起作用的是解决方案层级的“多启动项目”设置。
常见错误现象：改了 ApiService 的 launchSettings.json 加了环境变量，但 MessageWorker 启动时还是没读到；或者 WebApp 能连上 ApiService，但断点进不去，因为 ApiService 根本没以调试模式启动。
- 右键解决方案 → “属性” → 左侧选“通用属性” → “启动项目”
- 选择“多启动项目”，把三个项目动作都设为“启动”（不是“无操作”或“启动项目”）
- 注意启动顺序：VS 按列表顺序启动，但不保证进程就绪顺序；若 WebApp 依赖 ApiService，需在 WebApp 启动逻辑里加健康检查重试，不能靠列表位置保证
环境变量要分项目配，不能全塞进系统环境或全局 launchSettings
不同项目常需不同环境变量：ApiService 需要 ASPNETCORE_ENVIRONMENT=Development，MessageWorker 可能需要 WORKER_MODE=background，WebApp 则可能依赖 API_BASE_URL=http://localhost:5000。这些变量互不干扰，也不能混用。
直接在系统环境变量里设会导致所有进程共享，比如 ASPNETCORE_ENVIRONMENT 被 MessageWorker 继承后，Kestrel 可能意外启用开发中间件，暴露敏感信息。
- 每个项目右键 → “属性” → “调试”选项卡（VS2022）
- 在“环境变量”区域点击“添加”，填入键值对；不要复用其他项目的配置项
- WebApp 若是 Blazor Server，还需额外确认
ASPNETCORE_HTTPS_PORT和HTTP_PORT不与其他项目冲突（默认都是 5000/5001）
端口冲突和跨域问题比想象中更早出现
三个项目默认都用 5000 和 5001，即使你手动改了一个，VS 有时会在重启后悄悄还原。更隐蔽的是：Blazor Server 默认启用 HTTPS 重定向，而 ApiService 若未配 HTTPS，WebApp 发起的 fetch 请求会被浏览器拦截。
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
错误现象：Failed to load resource: net::ERR_CONNECTION_REFUSED 或 Blocked by CORS policy，但控制台显示 ApiService 已启动成功——其实是端口被占或协议不一致。
- ApiService 的
Properties\launchSettings.json中，确保applicationUrl明确指定为http://localhost:5000（去掉 https） - WebApp 的
launchSettings.json中，把applicationUrl改为http://localhost:5100，并删掉https条目 - MessageWorker 不监听 HTTP，无需改端口，但若它主动调用 ApiService，请确认 URL 写的是
http://localhost:5000，而非https或127.0.0.1（后者在某些 Windows 网络策略下不通）
调试器附加失败？检查平台工具集和输出路径是否一致
当 ApiService 断点不命中、MessageWorker 输出一闪而过、WebApp 页面空白时，大概率不是代码问题，而是调试器根本没 attach 上。VS 多项目联调要求所有项目生成目标一致：同一平台（x64/x86）、同一配置（Debug）、同一输出目录结构。
典型报错：The breakpoint will not currently be hit. No symbols have been loaded for this document. 或 Unable to start debugging. The startup project 'xxx' is not a debuggable project.
- 右键每个项目 → “属性” → “常规” → 确认“平台工具集”均为
v143（VS2022 默认），且“配置类型”为“应用程序(.exe)”或“动态库(.dll)”等可执行类型 - 检查“输出目录”：建议统一设为
$(SolutionDir)bin\$(Configuration)\，避免一个项目输出到bin\Debug\net8.0\，另一个到bin\x64\Debug\，导致 PDB 文件路径错乱 - 若用 .NET 8+，确认所有项目 SDK 类型一致（
<Project Sdk="Microsoft.NET.Sdk.Web">和<Project Sdk="Microsoft.NET.Sdk">混用可能导致调试符号加载失败）
最易被忽略的一点：多项目联调时，VS 不会自动等待前一个项目完全 ready 再启动下一个。ApiService 可能刚加载完 DI 容器，WebApp 就已发请求——此时没有重试机制，首请求必败。得在 WebApp 的 Program.cs 里手动加服务探测逻辑，而不是依赖启动顺序。
