Compose文件声明了外部卷，启动时却提示找不到。external: true表示卷由项目之外管理，Compose不会替你自动创建它。
遇到这个问题先查卷的实际名称与当前Docker上下文。生产数据卷不能用一个同名空卷草率代替。
外部卷与普通卷的生命周期不同
顶层volumes中设置external: true，Compose会查找平台已有卷；找不到就报错。普通由Compose管理的卷则可能在部署时创建。先运行docker compose config查看最终配置，确认服务挂载的源名称与顶层声明相符。
核对实际名称和运行环境
执行docker volume ls查找目标卷，并用docker context show确认命令连的是哪台Docker主机。外部卷可通过name指定实际平台卷名，避免误把Compose模型中的别名当成真实卷名。不同Docker上下文中的同名卷也不是同一份数据。
已有数据时先修正映射
卷已存在但名称不同，就在顶层声明中写清实际name，或修改服务引用，使其指向正确的顶层卷。先检查卷元数据与挂载路径，必要时查看原部署记录；不要通过删除旧卷来消除错误。
确实需要新卷才创建
若这是新环境且业务允许从空卷初始化，可执行docker volume create 卷名，然后再启动Compose。若应用预期读取原数据库文件，创建空卷只会让启动报错改变，不会恢复旧数据。
启动后验证数据而不只看容器状态
运行docker compose up -d与docker compose ps检查状态，再核对容器内挂载位置、应用实际数据和备份策略。切换环境时记录卷名、Docker上下文与数据迁移步骤。
云服务器上的变更建议
需要在VPS上复现时，可以在隔离环境先验证配置。萤光云与LightNode可按实际地区与资源需求选择；操作前保留快照或备份。
FAQ
问：docker compose down -v可以修复吗？答：它可能删除由Compose管理的卷，存在数据损失风险；先核对卷归属和实际内容。
温馨提示
温馨提示：涉及数据库卷时，先确认可用备份与恢复流程，避免把空卷误当成原卷。
