# EOS平台启动失败问题排查解决指南

本指南旨在帮助您快速定位并解决EOS平台在启动过程中遇到的失败问题。请根据您遇到的报错现象，在下方查找对应的处理步骤。

# 一、数据库连接与初始化类问题

1. 现象：启动报错 Table 'xxx.xxx' doesn't exist 或 relation "xxx" does not exist

解决方案:

检查数据库脚本。确认针对您当前使用的数据库类型（MySQL、Oracle、达梦、人大金仓等），single 或 all 目录下所有必需的SQL脚本都已完全执行。
检查数据库大小写敏感。对于区分大小写的数据库，请确认数据库中表名的大小写与SQL脚本中定义的一致。有时需要修改数据库配置或连接字符串参数。

2. 现象：启动报错 java.sql.SQLException: ORA-01702: a view is not appropriate here

解决方案:

检查数据库用户权限。这通常是因为数据库用户缺少访问视图或相关表的权限。请使用DBA账号登录数据库，为启动应用所用的数据库用户授予更充分的权限（如 CONNECT、RESOURCE、SELECT ANY TABLE 等）。

3. 现象：启动报错 com.mchange.v2.c3p0.ComboPooledDataSource [...] has been closed()

解决方案:

排查业务字典数据。这种异常通常是由于“业务字典”表中有循环引用或错误的数据导致启动过程陷入死循环。请将业务字典表数据回滚至初始状态，或逐条排查、删除有问题的数据后重新启动。

4. 现象：启动报错，提示找不到某个数据源（如 default 或自定义数据源）

解决方案:

检查Nacos配置。如果使用了Nacos配置中心，请登录Nacos控制台，确认对应应用的配置文件中数据源连接信息是否正确，并且Nacos中的配置优先于本地文件被加载。
检查本地配置文件。检查应用目录下的 user-config.xml 或 application.properties，确认数据源的URL、用户名、密码配置正确。特别注意密码中是否包含特殊字符（如 !、@），可能需要转义。
检查连接池配置。确认数据源的连接池配置，如 minPoolSize、maxPoolSize、acquireIncrement 等参数设置为大于0的合理值。如果设置不当（如最小连接数为0），可能导致启动时连接池初始化堵塞，超时报错。

5. 现象：启动后很快自动停止，无明显错误日志

解决方案:

前台运行查看日志。使用 ./startup.sh run 或 ./startup.sh console 命令在前台启动，可以直接看到实时输出的详细错误日志。最常见原因为系统内存不足或端口被占用。
检查JVM内存设置。检查启动脚本（如 startup.sh）中的 JAVA_OPTS 参数，确认 -Xms 和 -Xmx 设置的值不超过服务器可用内存。

6. 现象：启动报错 java.net.UnknownHostException: BPS-SERVER

解决方案:

检查Nacos服务注册。确认 BPS-SERVER 应用是否已经成功启动并注册到了相同的Nacos注册中心。可以在Nacos控制台的“服务管理”列表中查看。
检查服务名配置。在AFCenter的配置文件 application-afc.properties 中，确认 bps-application-name 的值是否精确设置为 BPS-SERVER（注意大小写）。
检查Nacos鉴权配置。如果Nacos开启了鉴权，请在 BPS-SERVER 的配置文件中正确配置Nacos的账号密码，否则服务将无法注册到Nacos。

7. 现象：启动报错 Missing license file：.\primetonlicense.xml

解决方案:

放置许可文件。将有效的 primetonlicense.xml 许可文件放置到启动脚本报错所提示的路径下。通常，许可文件应放在各应用（如 AFCENTER、BPS-SERVER）的 config/{应用名}/license 目录下。
检查许可有效性。确认许可文件未过期，且 cluster 属性值与您的部署模式（单机/集群）匹配。

8. 现象：启动报错 java.lang.NoClassDefFoundError 或 ClassNotFoundException

解决方案:

检查补丁操作。如果刚打过补丁，请检查是否严格按照补丁报告的说明进行操作，可能漏掉了某些需要替换或删除的jar包。例如，打合集补丁时可能需要删除 lib 下的其他版本jar包。
检查项目依赖。如果您是在IDE中启动自定义开发的应用，请检查Maven或Gradle依赖是否完整，并执行 mvn clean install 重新编译打包。
检查JDK版本。确认使用的JDK版本在产品的支持列表内。例如，某些功能可能不支持高版本的JDK（如JDK 21），建议使用JDK 1.8。