apollo在linux上启动失败主因是数据库认证插件不兼容、java_home未生效、服务启动顺序错误;mysql 8.0+需改用mysql_native_password插件并正确导入两库sql,配置文件须设apollo.profile=github且eureka.service.url完整有效,严格按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 - 三个服务的默认端口分别是:ConfigService(8080)、AdminService(8090)、Portal(8070),启动前用
lsof -i:8070等确认端口未被占用
真正容易被忽略的点是:分布式部署时,spring.datasource.url 里的 host 不能写 localhost,而要写实际 DB 所在机器的 IP;另外,apollo-env.properties 里 dev.meta 的值也得和你最终要访问的 ConfigService 地址一致,否则客户端连不上。











