OpenShift Kubernetes部署Jetty容器应用启动报URISyntaxException错误

排查思路 #

• 先核对运行身份差异：OpenShift默认使用随机非root UID运行容器，与本地Docker默认root运行的权限环境完全不同。首先exec进入异常Pod，验证/opt/application/webapps/application/路径是否真实存在，当前运行用户是否有该路径的读取权限，权限缺失可能导致Jetty读取路径时返回空值，拼接成非法的file://格式URI。
• 排查Jetty QuickStart配置：你使用的QuickStart模式会在应用打包阶段预生成web配置，检查项目WEB-INF/quickstart-web.xml文件是否存在写死的file://前缀路径，本地打包时的路径与OpenShift运行时路径不一致、或者OpenShift侧挂载了PVC/emptyDir到webapps目录覆盖了原有路径，都会导致预存路径失效。
• 开启调试日志定位异常URI来源：给Jetty启动参数添加-Dorg.eclipse.jetty.quickstart.AttributeNormalizer.LEVEL=DEBUG，重启Pod后查看日志，直接输出AttributeNormalizer类接收到的原始待解析URI值，即可定位是哪个配置项传入了非法路径。
• 对比环境变量差异：导出本地Docker运行容器的环境变量，和OpenShift Pod的环境变量做对比，OpenShift会自动注入大量服务、路由相关的环境变量，排查是否存在和Jetty相关的变量（如JETTY_WEBAPPS、JETTY_BASE等）被意外覆盖，导致路径配置错误。
• 临时关闭QuickStart验证根因：启动时添加参数-Dorg.eclipse.jetty.quickstart=false关闭QuickStart模式，如果应用能正常启动，即可确定问题出在QuickStart预生成配置与OpenShift运行环境不匹配，后续可调整QuickStart打包逻辑使用相对路径，或直接关闭该模式即可。

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