Jekyll serve未生成.well-known文件夹且文件访问触发下载求助

核心原因 #

Jekyll默认无法识别无扩展名的Matrix配置文件（client、server）的MIME类型，导致浏览器接收到文件时无法正确解析，从而触发下载行为。Matrix要求这两个文件的Content-Type为application/json（若为JSON格式）或text/plain（纯文本格式）。

解决思路 #

• 配置Jekyll的MIME类型映射
  在_config.yml中添加mime_types配置，指定目标文件的正确MIME类型：

  mime_types:
    ".well-known/matrix/client": "application/json"
    ".well-known/matrix/server": "application/json"
  

  保存后重新执行jekyll serve或jekyll build即可生效。

• 使用.metadata文件指定MIME类型
  如果上述方法不生效，可在.well-known/matrix目录下创建.metadata文件，内容如下：

  client: application/json
  server: application/json
  

  Jekyll会读取该文件的配置，为对应文件设置正确的响应头。

• 清理浏览器缓存
  本地测试时，浏览器可能缓存了旧的响应头信息，建议使用隐私模式访问或手动清空缓存后重新测试。

• 服务器端验证（部署后）
  若部署到外部服务器（如Nginx），需确保服务器未覆盖Jekyll设置的MIME类型。可在服务器配置中添加规则：

  location /.well-known/matrix/client {
    default_type application/json;
  }
  location /.well-known/matrix/server {
    default_type application/json;
  }
  

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