在React SSR (服务端渲染) 项目中，部署后经常会遇到无法访问位于 public 目录下的 .well-known 文件夹中的静态资源，例如 assetlinks.json 文件的问题。通常，这个问题是由于 Nginx 服务器的配置限制导致的。本文将提供详细的配置步骤，指导你正确地设置 Nginx，以便能够正常访问 .well-known 目录下的文件。
在基于React的服务端渲染（SSR）项目中，我们经常需要提供一些位于.well-known目录下的静态文件，例如assetlinks.json，用于Android App Links验证或其他用途。然而，在部署到生产环境后，通过Nginx访问这些文件时，可能会遇到404错误。这通常是因为Nginx默认配置阻止了对以点开头的目录的访问。以下提供一种解决方案，通过修改Nginx配置，允许访问.well-known目录下的文件。
步骤一：放置 assetlinks.json 文件
首先，将 assetlinks.json 文件放置在一个合适的目录下。通常，选择一个Nginx能够访问的静态资源目录。例如：
/usr/share/nginx/html/assetlinks.json
确保Nginx用户（通常是www-data或nginx）对该目录具有读取权限。
步骤二：配置 Nginx
接下来，修改 Nginx 配置文件，通常位于 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/default.conf。找到你网站的 server 块，并在其中添加一个 location 块，用于处理对 .well-known/assetlinks.json 的请求。
server {
# ... 其他配置 ...
location = /.well-known/assetlinks.json {
root /usr/share/nginx/html;
try_files /assetlinks.json =404;
}
# ... 其他配置 ...
}这段配置的含义如下：
- location = /.well-known/assetlinks.json: 精确匹配对 /.well-known/assetlinks.json` 的请求。
- root /usr/share/nginx/html: 指定静态资源文件的根目录。 Nginx将会在该目录下查找 assetlinks.json 文件。
- try_files /assetlinks.json =404: 尝试查找 /assetlinks.json 文件。如果找不到，则返回 404 错误。
注意事项:
- root 指令定义了查找文件的根目录，而 alias 指令则定义了 URL 路径到文件系统路径的映射。 使用 root 指令时，Nginx 会将请求的 URI 附加到 root 指令指定的路径上。 例如，如果请求的 URI 是 /.well-known/assetlinks.json，并且root指令设置为/usr/share/nginx/html，那么 Nginx 将会查找文件/usr/share/nginx/html/.well-known/assetlinks.json。使用alias指令时，Nginx 会将请求的 URI 替换为alias指令指定的路径。 例如，如果请求的 URI 是/.well-known/assetlinks.json，并且 alias 指令设置为 /usr/share/nginx/html/assetlinks.json，那么 Nginx 将会查找文件 /usr/share/nginx/html/assetlinks.json。
- 如果你的项目中有其他的 .well-known 目录下的文件需要访问，可以添加类似的 location 块。
- 根据你的 Nginx 配置文件的结构，可能需要调整配置的位置。
步骤三：重启 Nginx
修改完 Nginx 配置文件后，需要重启 Nginx 服务，使配置生效。
sudo systemctl restart nginx
或者，如果你使用的是其他 Linux 发行版或不同的服务管理工具，请使用相应的命令重启 Nginx。
验证
完成上述步骤后，可以通过浏览器访问 yourdomain.com/.well-known/assetlinks.json，验证是否能够正常访问 assetlinks.json 文件。
总结
通过配置 Nginx，我们可以轻松地解决 React SSR 项目中无法访问 .well-known 目录下的静态资源的问题。 关键在于正确配置 location 块，并确保 Nginx 能够找到对应的文件。 遵循以上步骤，可以确保你的 Android App Links 验证或其他需要 .well-known 目录下的文件的功能正常工作。
