安装Identity IQ时出错，组件启动失败且SailPoint页面报404错误

报错信息 #

FAIL - Encountered exception [org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/identityiq]]]
访问SailPoint页面出现404错误

排查步骤 #

• 查看完整异常堆栈
  打开Tomcat日志目录下的catalina.out、localhost.log或localhost.err文件，找到LifecycleException对应的完整报错信息，重点关注Caused by开头的行，这是触发启动失败的根本原因（常见原因：数据库连接失败、依赖jar缺失、权限不足）。

• 验证部署包完整性
  检查identityiq.war是否损坏，可重新解压部署；确认webapps/identityiq/WEB-INF/lib目录下所有依赖jar存在且完整，尤其是数据库驱动jar（如mysql-connector-java.jar、ojdbc8.jar）。

• 核对数据库配置
  打开webapps/identityiq/WEB-INF/classes/identityiq.properties，检查以下参数是否正确：

  • dataSource.url：数据库连接地址，格式需匹配对应数据库（如MySQL：jdbc:mysql://localhost:3306/identityiq?useSSL=false）
  • dataSource.username/dataSource.password：数据库访问账号密码，确保该账号有库表的读写、创建权限
    同时确认数据库服务已正常启动，端口可访问。

• 检查Tomcat权限与端口

  • 确保Tomcat运行用户对webapps/identityiq目录有读写权限，避免因权限不足导致文件无法加载
  • 确认Tomcat HTTP端口（默认8080）未被占用，访问时使用正确端口，比如修改过端口后需访问http://localhost:自定义端口/identityiq

• 验证JDK版本兼容性
  确认Tomcat使用的JDK版本符合Identity IQ官方要求（如v8.x版本需JDK 8，v9.x+需JDK 11），通过执行java -version查看版本，同时检查Tomcat的JAVA_HOME环境变量配置正确。

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