Tomcat 9部署XNAT Web应用启动失败技术求助

核心问题分析 #

从报错栈的NullPointerException出现在String.startsWith方法，结合AbstractFileResourceSet.file的调用链路，直接原因是资源路径参数为空——大概率是${xnat.home}变量未被正确解析，导致context.xml中PreResources的base路径为null，触发空指针异常。

分步修复步骤 #

1. 修复systemd单元文件的语法错误 #

你的CATALINA_OPTS环境变量存在引号嵌套错误，导致xnat.home参数无法被Tomcat识别：

# 错误写法
Environment="CATALINA_OPTS="-Xms512M -Xmx1024M -server -XX:+UseParallelGC -Dxnat.home=/data/xnat/home"

改为以下任意一种正确写法：

# 方案1：用单引号包裹整体
Environment='CATALINA_OPTS="-Xms512M -Xmx1024M -server -XX:+UseParallelGC -Dxnat.home=/data/xnat/home"'
# 方案2：转义内部双引号
Environment="CATALINA_OPTS=\"-Xms512M -Xmx1024M -server -XX:+UseParallelGC -Dxnat.home=/data/xnat/home\""

2. 验证XNAT home路径的存在与权限 #

• 确保/data/xnat/home及子目录已创建：

  mkdir -p /data/xnat/home/plugins
  

• 赋予xnat用户完整权限：

  chown -R xnat:xnat /data/xnat/home
  chmod -R 755 /data/xnat/home
  

  Tomcat以xnat用户运行，权限不足会导致路径无法访问，间接触发空指针错误。

3. 简化systemd的ReadWritePaths配置 #

当前配置同时指定了/opt/tomcat/webapps/和/var/lib/tomcat/webapps/，易引发路径冲突。只保留实际使用的路径：

# 保留实际生效的路径，注释或删除冗余项
ReadWritePaths=/opt/tomcat/webapps/
ReadWritePaths=/data/xnat/home
ReadWritePaths=/opt/log/tomcat/

4. 修正context.xml的XML语法错误 #

你的配置文件开头缺少XML声明的起始<，导致配置无法正常加载：

# 错误写法
xml version="1.0" encoding="utf-8"?>
# 正确写法
<?xml version="1.0" encoding="utf-8"?>

5. 重启服务并验证 #

完成修改后，重新加载systemd配置并重启Tomcat：

systemctl daemon-reload
systemctl restart tomcat

查看日志确认启动状态：

tail -f /opt/log/tomcat/catalina.out

额外排查建议 #

如果上述步骤无效，可尝试：

• 临时关闭NoNewPrivileges=true配置，验证是否为权限限制导致路径访问失败
• 直接在Tomcat的bin/setenv.sh中配置CATALINA_OPTS，规避systemd环境变量解析问题
• 检查PostgreSQL的pg_hba.conf是否允许xnat用户本地连接（当前报错与DB无关，但后续启动成功后需确保DB链路正常）

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