Directus文件分块上传功能配置问题解析

问题背景

在使用Directus 11.5.1版本时，当启用文件分块上传功能后，通过Web界面上传文件会出现失败的情况。这个问题主要源于系统生成的TUS上传端点URL不正确，导致客户端无法正确连接到文件上传服务。

技术分析

分块上传机制

Directus使用TUS协议实现文件分块上传功能。TUS是一种基于HTTP的开放协议，用于可恢复的文件上传。当启用该功能时，系统应该生成正确的上传端点URL，格式通常为：

{正确的基础URL}/tus/{文件唯一标识符}

问题表现

在实际运行中，系统生成的URL格式错误，变成了：

http://files/tus/9501ca3339c77c961e7bea8f8e7d9fb4

这种URL缺少了正确的主机名和端口信息，导致客户端无法建立连接。

根本原因

经过技术分析，这个问题通常是由于缺少必要的环境变量配置导致的。特别是PUBLIC_URL环境变量未正确设置时，系统无法生成完整的上传端点URL。

解决方案

配置环境变量

要解决这个问题，必须确保以下环境变量正确配置：

1. TUS_ENABLED=true - 启用分块上传功能
2. PUBLIC_URL - 必须设置为应用可访问的完整基础URL

配置示例

在Docker环境中，正确的配置应该类似于：

environment:
  - TUS_ENABLED=true
  - PUBLIC_URL=http://your-domain.com:8055

测试验证

配置完成后，上传文件时生成的URL应该变为：

http://your-domain.com:8055/tus/9501ca3339c77c961e7bea8f8e7d9fb4

注意事项

1. 修改配置后需要重启服务使更改生效
2. 测试上传时，建议使用新文件名或清除浏览器本地存储，避免缓存旧的错误URL
3. 确保网络设置允许客户端访问配置的PUBLIC_URL

总结

Directus文件分块上传功能依赖正确的URL生成机制，而PUBLIC_URL环境变量是其中的关键配置项。通过正确配置这一参数，可以确保TUS上传端点URL生成正确，从而解决文件上传失败的问题。对于生产环境部署，建议在启用分块上传功能前，先验证所有相关配置项的正确性。