如何为 ASP.NET Core 的 Bug 报告创建最小复现项目（minimal repro）-育师

如何为 ASP.NET Core 的 Bug 报告创建最小复现项目（minimal repro）

【免费下载链接】aspnetcoreASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.项目地址: https://gitcode.com/GitHub_Trending/as/aspnetcore

当你准备向 ASP.NET Core 报告一个 issue 时，产品团队大概率会要求你提供一个「最小复现项目」（minimal reproduction project，下称 repro）。本文按仓库文档 docs/repro.md 给出创建 repro 的完整操作路径：从选模板、裁剪代码，到发布为公开仓库，以及提交前必须自查的安全红线，最终得到一个团队能以最少工作量直接跑起来验证的问题项目。

什么算最小复现项目

文档给出的定义是：repro 是一个能够以产品团队最少的工作量重现所报告行为的项目，其中只包含演示该行为所必需的最少代码。

团队要求 repro 有两个目的：

帮助你通过在新项目中重新创建该行为来验证自己的假设；
消除歧义、加快调查速度。在部分场景下，团队甚至可能直接给出 workaround。

这意味着 repro 不要求还原你的完整业务项目，反而要求你主动裁剪到「行为还能复现」为止。

两种提供方式

文档列出两种提供 repro 的方式：

公开的网络托管 REPL 环境——文档称这是「第一种、更简单」的选项，分别有面向 ASP.NET Core 和 Blazor 的两个环境，具体地址见原文 docs/repro.md。适合能快速在新环境里敲出复现代码的简单场景。
公开 GitHub 仓库中的项目——步骤更多，但本文的主路径。下面的步骤全部来自该文档。

主路径：在公开仓库中创建 repro 项目

按以下顺序操作，每一步都是文档中明确的「make sure」要求，提交前可逐项自查：

基于 ASP.NET Core 项目模板新建一个项目。如果该项目类型有Empty*模板，请使用Empty*模板，而不是功能齐全的完整版模板——这保证项目起点足够干净。
只加入复现所报告行为所需的最少量代码。不要搬运原项目的相关模块，只保留触发问题的代码。
不要添加任何与该行为无关的依赖（Please do not add any dependencies that are irrelevant to the behavior）。
将项目托管为 GitHub 上的公开（public）仓库。团队需要能直接访问并打开它。
确认项目中不含任何二进制文件——通常就是项目里的bin和obj文件夹。文档特别强调这一步很重要：团队无法打开 issue 里的 zip 附件，而 zip 文件是团队会尽力规避的潜在攻击向量。所以 repro 只能走公开仓库，不能以附件形式提交。

安全与合规红线

文档列出的三条约束优先级最高，任何一条违反都可能导致 repro 不可用甚至引发安全事故：

绝不在复现项目中包含任何敏感信息（sensitive information）；
绝不在 repro 中包含任何不打算公开（not intended to be public）的代码；
不要引用任何外部服务或数据源。

最后一条还有一层实际意义：repro 必须自包含，团队不依赖你的外部服务也能把行为跑出来，否则「最少工作量」就无法成立。

下一步：把 repro 挂到 issue 上

repro 准备好后，按 CONTRIBUTING.md 的流程提交问题：

先检索是否已存在相同 issue；如果存在，用 👍 upvote，并补充评论说明你的独特场景与需求——upvote 和清晰的影响说明有助于团队优先处理重要问题；
如果找不到已有 issue，在对应的仓库（ASP.NET Core 本仓库 dotnet/aspnetcore）新建 issue，附上 repro 仓库链接；
注意例外：安全相关的问题不走公开 issue，文档要求通过邮件私下提交给 Microsoft Security Response Center（MSRC）。