Django原生Storage不支持GridFS，需自定义子类：重写path()抛NotImplementedError；exists()查filename；_save()用new_file()分块写入；_open()用get_last_version()流式读取；delete()先查_id再删；URL须经视图中转并校验。
不能直接用 Django 的 Storage 接口原生支持 GridFS，因为 Django 的文件存储抽象依赖于「文件路径可寻址」和「原子写入+重命名」语义，而 GridFS 是分块存储、无真实文件系统路径的。必须自定义 Storage 子类，并主动绕过 Django 对 path()、exists() 等方法的默认假设。
GridFS 不支持 path() 和本地文件系统操作
Django 在生成 URL、调用 url()、检查文件是否存在（如模板中 {% static %} 或管理后台上传预览）时，会尝试调用 storage.path(name) —— 这个方法在 GridFS 场景下根本无意义，因为文件不存在于磁盘路径中。若不重写，会抛出 NotImplementedError 或 ValueError。
- 必须重写
path(self, name)并主动抛出NotImplementedError，同时确保所有调用方（如 Admin、collectstatic）不依赖它 -
exists(self, name)需查 GridFS 的fs.find_one({"filename": name})，注意 GridFS 的filename字段是精确匹配，不支持目录层级语义（如img/logo.png就是完整 filename） -
listdir(self, path)无法真正实现「目录遍历」，只能返回空元组或按前缀查fs.find({"filename": {"$regex": f"^{path}/"}})，但性能差且非标准
自定义 GridFSStorage 必须接管读写生命周期
GridFS 的写入不是「一次写完」，而是通过 fs.new_file() 获取一个类似文件句柄的对象，再分块写入；读取则需用 fs.get_last_version(filename) 或 fs.find_one({"filename": ...})。Django 的 _save() 和 _open() 方法必须严格适配这个流程。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
-
_save(self, name, content)中：用self.fs.new_file(filename=name, **self.default_metadata)创建文件对象，再循环content.chunks()写入，最后调用.close()触发实际存储 -
_open(self, name, mode='rb')中：用self.fs.get_last_version(filename=name)获取 GridOut 对象，包装成io.BytesIO或继承File的轻量封装类（避免加载全部内容到内存） -
delete(self, name)必须调用self.fs.delete(file_id)，但注意：GridFS 没有「按 filename 删除」的原子接口，得先find_one拿到_id，再delete，否则会残留 chunks
URL 生成不能依赖 base_url 自动拼接
Django 默认用 self.base_url + name 生成静态资源 URL，但 GridFS 文件无法被 Web 服务器（Nginx/Apache）直接服务——必须经由 Django 视图中转。所以 base_url 应设为一个真实路由（如 /gridfs/），并在对应视图里用 fs.get_last_version() 读取并流式响应。
- 设置
base_url = '/gridfs/'，并在urls.py添加path('gridfs//', gridfs_serve_view) - 视图函数里必须做安全校验：
name不能含..、不能为空、建议限制长度（GridFS filename 最大 1024 字节） - 响应头需设
Content-Type（从 GridFS metadata 或文件扩展名推断）、Content-Length（gridout.length）、Cache-Control（静态资源建议 max-age=31536000） - 不要用
HttpResponse(gridout.read())，改用StreamingHttpResponse((chunk for chunk in gridout), content_type=...)防止大文件 OOM
GridFS 的 chunk 大小（默认 255KB）和文件元数据（uploadDate、md5）是隐式存在的，但 Django 的 size、created_time 等属性需手动映射；更麻烦的是，多个同名文件版本共存时，get_last_version 可能返回非预期版本——生产环境务必约定 filename 唯一性，或引入哈希前缀（如 f"{hash(content)}_{name}"）。
