Docker安装AZCore时出现authserver+worldserver不存在报错如何解决

排查&修复步骤 #

• 先清理历史构建残留：进入项目根目录执行以下命令，销毁未正常运行的容器、清理缓存卷、删除残留的dist目录

  docker compose down --volumes --remove-orphans
  rm -rf ./dist
  

• 恢复编译配置默认值：如果之前修改过.env或docker-compose.yml中的编译相关参数（比如BUILD_MODULES、BUILD_EXTRA_FLAGS等），先恢复为官方默认配置，排除参数错误导致的编译跳过问题。
• 强制全量重新编译：不要直接执行普通启动命令，运行带强制构建参数的启动命令，完整走一遍核心编译流程：

  docker compose up --build
  

  核心编译耗时根据机器配置在10~40分钟不等，全程不要手动中断进程，注意控制台输出是否有报错信息。
• 编译完成后校验：编译流程结束后，先检查./dist/bin目录是否已生成worldserver和authserver两个可执行文件，确认存在后再正常启动服务即可。

极端情况排查 #

如果执行上述步骤后仍未生成对应文件，排查以下基础环境问题：

• 内存：编译AzerothCore最少需要4G可用内存，内存不足时编译进程会被系统静默杀掉，无明确报错但不会生成最终二进制文件。
• 磁盘：编译全程需要至少20G空闲磁盘空间，空间不足会导致编译中途中断。
• 自定义模块：如果添加了第三方自定义模块，先全部移除后重新编译，部分模块兼容性问题会导致核心编译失败。

内容的提问来源于stack exchange，提问作者disrudecoder