.net 6.0 下载特殊后缀（.scl）的文件反回404错误的原因

一、前言

最近有一个需求就是，需要生成一份PLC的 SCL 代码，将路径返回给前端，并提供下载的接口，导入博图进行测试。文件生成放在了 wwwroot 文件夹， 但是访问下载的时候却报 404 Not Found。一开始我以为是没有注册 ‘app.UseStaticFiles()‘ 中间件，后来发现有注册。
后来发现同目录下的.txt文件是可以被访问到的。到这里，我猜测可能是特殊后缀的文件需要有特殊的设置。

二、问题原因

经了解， .net 支持一些常用的格式文件下载，如下所示：

• .txt：文本文件
• .csv：逗号分隔值文件
• .pdf：Portable Document Format文件
• .docx：Microsoft Word文档
• .xlsx：Microsoft Excel电子表格
• .pptx：Microsoft PowerPoint演示文稿
• .png：Portable Network Graphics图像
• .jpg：JPEG图像
• .gif：Graphics Interchange Format图像
• .mp3：MPEG-1 Audio Layer 3音频文件
• .mp4：MPEG-4视频文件

由于我需要下载的后缀是（.scl）,属于是 MIME（Multipurpose Internet Mail Extensions） 类型的文件，所以我们需要指定其 ‘Content-Type’的值。

MIME（Multipurpose Internet Mail Extensions）多用途互联网邮件扩展类型，是一个互联网标准，扩展了电子邮件的标准，使其能够支持：非ASCII字符文本；非文本格式附件（二进制、声音、图像等）；由多部分（multiple parts）组成的消息体；包含非ASCII字符的头信息（Header information）。

三、解决方案

既然知道问题所在了， 解决起来就比较简单了。

    /// <summary>
    /// 初始化文件 ContentType 提供器
    /// </summary>
    /// <returns></returns>
    public static FileExtensionContentTypeProvider GetFileExtensionContentTypeProvider()
    {
        var fileExtensionProvider = new FileExtensionContentTypeProvider();
        fileExtensionProvider.Mappings[".scl"] = "application/octet-stream";
        fileExtensionProvider.Mappings[".iec"] = "application/octet-stream";
        fileExtensionProvider.Mappings[".patch"] = "application/octet-stream";
        fileExtensionProvider.Mappings[".apk"] = "application/vnd.android.package-archive";
        fileExtensionProvider.Mappings[".pem"] = "application/x-x509-user-cert";
        fileExtensionProvider.Mappings[".gzip"] = "application/x-gzip";
        fileExtensionProvider.Mappings[".7zip"] = "application/zip";
        fileExtensionProvider.Mappings[".jpg2"] = "image/jp2";
        fileExtensionProvider.Mappings[".et"] = "application/kset";
        fileExtensionProvider.Mappings[".dps"] = "application/ksdps";
        fileExtensionProvider.Mappings[".cdr"] = "application/x-coreldraw";
        fileExtensionProvider.Mappings[".shtml"] = "text/html";
        fileExtensionProvider.Mappings[".php"] = "application/x-httpd-php";
        fileExtensionProvider.Mappings[".php3"] = "application/x-httpd-php";
        fileExtensionProvider.Mappings[".php4"] = "application/x-httpd-php";
        fileExtensionProvider.Mappings[".phtml"] = "application/x-httpd-php";
        fileExtensionProvider.Mappings[".pcd"] = "image/x-photo-cd";
        fileExtensionProvider.Mappings[".bcmap"] = "application/octet-stream";
        fileExtensionProvider.Mappings[".properties"] = "application/octet-stream";
        fileExtensionProvider.Mappings[".m3u8"] = "application/x-mpegURL";
        fileExtensionProvider.Mappings[".*"] = "application/octet-stream";
        return fileExtensionProvider;
    }

在 Startup类中的 Configure 中配置 ContentType 提供器

app.UseStaticFiles(new StaticFileOptions
{
    ContentTypeProvider = GetFileExtensionContentTypeProvider()
});

拓展： application/octet-stream 是什么类型

application/octet-stream 是一种通用的二进制文件类型，表示一种流式的数据格式。它通常用于表示二进制文件，如文档、图像、音频、视频等。这种类型的数据通常需要进行特定的解码才能被正确读取和处理。在Web开发中，当你想让用户下载一个文件时，常常会使用application/octet-stream作为响应的MIME类型。这样，浏览器就会知道它应该尝试将响应的内容作为文件进行下载，而不是尝试在浏览器中打开或执行它。

例如，在HTTP响应头中，可以使用Content-Disposition来告诉浏览器将响应的内容作为文件下载：

Content-Disposition: attachment; filename="converts.scl"

这样，浏览器就会提示用户下载名为”converts.scl”的文件，而不是尝试在浏览器中打开或执行它。