Apollo在Linux启动失败主因是数据库认证、JAVA_HOME未生效或服务顺序错误；MySQL 8.0+需改认证插件为mysql_native_password并正确导入两库SQL；配置须分环境、禁空格、配全URL及profile，且严格按config→admin→portal顺序启动。
Apollo 在 Linux 上跑不起来，90% 是卡在数据库认证、
未生效、或服务启动顺序错这三处——不是配置写得不对，而是环境没真正就绪。
MySQL 8.0+ 连不上？先改认证插件再导入 SQL
MySQL 8.0 默认用
，但 Apollo 内置驱动只认
。报错
就是这个原因，跟密码对不对无关。
用 root 登录 MySQL 后立刻执行：
必须在这条之后，再导入
和
；漏掉
，Portal 根本打不开
两个库要分开建：
（全局一套）、
（每个环境一套），不能共用一个库
值里不能含空格，否则连接池初始化失败，日志只显示
，实际是解析中断
application-github.properties 配置必须改对的三处
这个文件在
和
下各一份，内容相似但作用不同。最容易被忽略的是：
Docker Desktop（linux）
当前 Docker 最新稳定版本之一，主要针对稳定性和兼容性进行了修复优化，适合生产环境与日常开发使用。该版本继续强化 AI 开发支持、容器日志管理以及 Docker Engine 的安全能力，对 Windows/macOS/Linux 平台兼容性进行了进一步优化。
下载
必须指向你建好的
，端口、库名、参数（如
）一个都不能少
要写成完整地址，例如
；如果是多节点，用英文逗号分隔多个地址
必须显式设置
，否则 Spring Boot 会 fallback 到空 profile，读不到这个文件，所有数据库配置都失效
服务必须按 configservice → adminservice → portal 顺序启动
Portal 依赖 AdminService 提供 API，AdminService 又依赖 ConfigService 的元数据服务。强行先启 Portal，它会一直报 500 或白屏。
启动前检查
：运行
，确认输出非空，且该路径下存在
ConfigService 启动后，立刻验证 Eureka 是否注册成功：
应返回 XML 或 JSON 列表；如果返回 404 或空，大概率是
没配对，或机器有
网卡导致注册了错误 IP
若有多网卡，加 JVM 参数屏蔽干扰：
每个服务启动脚本（
）都要加
强制前台运行，方便看日志；别等全部启完再查，出问题立刻停掉重试
最常被跳过的一步：Portal 启动前，必须确认
已导入、
中
指向的是 ConfigService 地址（比如
），而不是 localhost 或 127.0.0.1 —— 容器或跨主机部署时，这个地址必须可被 Portal 进程直接访问到。
$JAVA_HOMEcaching_sha2_passwordmysql_native_passwordClient does not support authentication protocolALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';apolloportaldb.sqlapolloconfigdb.sqlapolloportaldb.sqlApolloPortalDBApolloConfigDBspring.datasource.passwordConnection refusedapollo-configservice/conf/apollo-adminservice/conf/spring.datasource.urlApolloConfigDB?useSSL=false&characterEncoding=utf8eureka.service.urlhttp://192.168.1.10:8080/eureka/apollo.profile=github$JAVA_HOMEecho $JAVA_HOME/bin/javacurl http://localhost:8080/eureka/appseureka.service.urldocker0-Dspring.cloud.inetutils.ignoredInterfaces[0]=docker0 -Dspring.cloud.inetutils.ignoredInterfaces[1]=veth.*startup.sh-fApolloPortalDBapollo-env.propertiesdev.metahttp://localhost:8080