文件损坏提示实为校验拦截，须依次验证文件大小与完整性、检查文件名与目录名严格一致、确认safetensors头部元数据有效、更换直链下载方式重试，跳过任一环节错误将持续复现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
LiblibAI模型下载后提示“文件损坏”或“无法加载权重”，实际并非文件真损坏，而是校验机制拦截了不完整、被截断、编码异常或路径错位的模型文件；必须按顺序验证文件完整性、检查文件名与目录名一致性、确认safetensors头部结构、重试下载方式，跳过任意一步都可能让错误持续复现。
验证模型文件是否真正完整
浏览器下载中断、网络抖动或磁盘空间不足，会导致.safetensors文件末尾缺失关键校验块，系统读取时直接报“corrupted file”。
打开你保存模型的文件夹，右键点击刚下载的文件（如majicMIX_realistic.safetensors）→ 选择“属性” → 查看“大小”字段：SDXL类CHECKPOINT模型应≥4.8GB，LoRA类通常在100MB～600MB之间。若显示为0字节、几十KB或明显偏小（如3.2GB），说明下载未完成，必须重新下载。
用文本编辑器（如VS Code、Notepad++）以UTF-8无BOM方式打开该文件，滚动到底部——正常safetensors文件末尾必须包含类似{"__metadata__":{...}}的JSON结构；若结尾是乱码、空行、或突然中断在"shape"字段中间，就是被截断了。
检查文件名与目录名是否严格一致
LiblibAI新版加载器强制要求模型主文件名与所在文件夹名完全相同，且不含任何空格、中文括号或特殊符号。
例如文件是svdq-int4_r32-flux.1-dev.safetensors，那么它必须存放在名为svdq-int4_r32-flux.1-dev的文件夹内；若文件夹叫flux_dev_v2或svdq-int4_r32-flux.1-dev(已下载)，加载器将拒绝识别并报“file not found or corrupted”。
【模型目录名必须与主文件名完全一致】，连末尾的点号、横线数量、大小写都不能差——比如FluxDev和fluxdev会被视为两个不同模型。
确认safetensors头部是否含有效元数据
safetensors格式依赖头部嵌入的JSON元数据来定位权重张量，若该部分损坏或被误删，模型虽能解压但无法加载。
方法一：用Python快速验证
安装pip install safetensors后，在终端执行：python -c "from safetensors import safe_open; safe_open('your_model.safetensors', framework='pt')"。
若报UnexpectedEofError或InvalidHeaderError，说明头部损坏。
方法二：用在线工具检测
访问https://safetensors-validator.liblib.dev → 拖入你的.safetensors文件 → 点击“Validate” → 若返回“Header is invalid”或“Metadata parse failed”，即确认头部异常。
更换下载方式重试（绕过浏览器缓存污染）
浏览器自动续传功能有时会把上一次失败的残缺片段拼进新下载中，导致看似“下载完成”实则内容混杂。
第一步：清空浏览器下载缓存 → 打开Chrome/Edge设置 → “隐私和安全” → “清除浏览数据” → 勾选“下载历史记录”+“缓存的图片和文件” → 时间范围选“所有时间” → 清除。
第二步：改用开发者工具直链下载 → 在模型页按F12 → Network标签 → 点击【下载模型】→ 找到状态200的GET请求 → 右键 → Copy → Copy as cURL (bash) → 粘贴到终端，末尾加--output="fixed_model.safetensors"执行。
【注意】若复制的cURL命令里含-H "Authorization: Bearer ..."，说明鉴权有效；若没有该头，说明抓包失败，需重试或换账号登录。
手动修复常见损坏类型（仅限LoRA类小模型）
部分LoRA模型因上传时压缩异常，导致.safetensors内部tensor name错位，表现为“key not found”而非“corrupted”。
方法一：用safetensors-cli工具重写
执行：safetensors-cli convert your_broken_lora.safetensors fixed_lora.safetensors，该命令会重建标准头部并校验全部tensor。
方法二：降级兼容性加载
在LiblibAI参数面板中，找到“模型加载选项”→ 启用“Legacy tensor mapping fallback”开关 → 再次尝试加载。此开关会忽略部分name mismatch，仅适用于LoRA/VAE类小模型，不适用于CHECKPOINT大模型。
