apollo在linux上启动失败90%因三处：mysql 8.0+需先执行alter user...caching_sha2_password改为mysql_native_password再导入sql；$java_home必须非空且含/bin/java；服务须严格按configservice→adminservice→portal顺序启动。
Apollo 在 Linux 上跑不起来，90% 是卡在数据库认证、$JAVA_HOME 未生效、或服务启动顺序错这三处——不是配置写得不对，而是环境没真正就绪。
MySQL 8.0+ 连不上？先改认证插件再导入 SQL
MySQL 8.0 默认用 caching_sha2_password，但 Apollo 内置驱动只认 mysql_native_password。报错 Client does not support authentication protocol 就是这个原因，跟密码对不对无关。
- 用 root 登录 MySQL 后立刻执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 必须在这条之后，再导入
apolloportaldb.sql和apolloconfigdb.sql；漏掉apolloportaldb.sql，Portal 根本打不开 - 两个库要分开建：
ApolloPortalDB（全局一套）、ApolloConfigDB（每个环境一套），不能共用一个库 -
spring.datasource.password值里不能含空格，否则连接池初始化失败，日志只显示Connection refused，实际是解析中断
application-github.properties 配置必须改对的三处
这个文件在 apollo-configservice/conf/ 和 apollo-adminservice/conf/ 下各一份，内容相似但作用不同。最容易被忽略的是：
-
spring.datasource.url必须指向你建好的ApolloConfigDB，端口、库名、参数（如?useSSL=false&characterEncoding=utf8）一个都不能少 -
eureka.service.url要写成完整地址，例如http://192.168.1.10:8080/eureka/；如果是多节点，用英文逗号分隔多个地址 - 必须显式设置
apollo.profile=github，否则 Spring Boot 会 fallback 到空 profile，读不到这个文件，所有数据库配置都失效
服务必须按 configservice → adminservice → portal 顺序启动
Portal 依赖 AdminService 提供 API，AdminService 又依赖 ConfigService 的元数据服务。强行先启 Portal，它会一直报 500 或白屏。
- 启动前检查
$JAVA_HOME：运行echo $JAVA_HOME，确认输出非空，且该路径下存在/bin/java - ConfigService 启动后，立刻验证 Eureka 是否注册成功：
curl http://localhost:8080/eureka/apps应返回 XML 或 JSON 列表；如果返回 404 或空，大概率是eureka.service.url没配对，或机器有docker0网卡导致注册了错误 IP - 多网卡场景下，需在
startup.sh的 JVM 参数里加：-Dspring.cloud.inetutils.ignoredInterfaces[0]=docker0 -Dspring.cloud.inetutils.ignoredInterfaces[1]=veth.*
最常被跳过的动作是：改完 MySQL 认证插件后没重启 mysqld，或者导入 SQL 时用了非 root 用户权限不足；apollo.profile=github 这一行容易被注释掉，一启动就 fallback 到空配置——这些地方不细看日志，根本找不到根因。
