Tomcat上JSPWiki无法识别异盘页面目录问题求助

问题详情 #

• 使用环境：JSPWiki 2.11.3 + Tomcat 10.1.6（Arch Manjaro系统）
• 配置操作：在jspwiki-custom.properties中设置页面存储目录为异盘挂载点路径/home/rsc/share/tomcat/lib/jw
• 异常现象：JSPWiki无法正常使用该目录，但权限配置无问题——tomcat用户属于该目录及对应符号链接的用户组，组成员拥有递归读写及文件夹执行权限
• 对比验证：
  • 将页面目录复制到tomcat/lib目录下并修改配置后，JSPWiki可正常运行
  • 相同配置在Debian 11/Tomcat 10.1.4环境下可正常工作

排查及解决方法 #

1. 检查Tomcat安全策略限制 #

Arch系Tomcat默认可能启用严格的安全策略，限制webapp访问外部挂载目录：

• 编辑Tomcat配置目录下的catalina.policy文件，添加针对JSPWiki的目录权限声明：

grant codeBase "file:${catalina.base}/webapps/jspwiki/-" {
    permission java.io.FilePermission "/home/rsc/share/tomcat/lib/jw/-", "read,write,delete";
    permission java.io.FilePermission "/home/rsc/share/tomcat/lib/jw", "read";
};

• 保存后重启Tomcat测试

2. 检查挂载点文件系统属性 #

部分文件系统挂载时可能带有noexec等限制属性，导致无法正常访问：

• 查看挂载参数：执行命令 mount | grep /home/rsc/share
• 若发现noexec参数，修改/etc/fstab中对应的挂载条目，添加exec参数，示例：

/dev/sdX1 /home/rsc/share ext4 defaults,exec 0 2

• 执行 mount -o remount /home/rsc/share 重新挂载后测试

3. 开启Tomcat符号链接支持 #

Tomcat 10.1.x可能默认禁止webapp访问符号链接指向的外部目录：

• 编辑conf/context.xml，在<Context>标签中添加allowLinking="true"属性：

<Context allowLinking="true">
    <!-- 原有配置内容 -->
</Context>

• 注意：该选项会降低安全防护级别，仅在可信环境中使用

4. 检查安全模块（SELinux/AppArmor）限制 #

Arch系可能启用SELinux或AppArmor，阻断了Tomcat对挂载目录的访问：

• SELinux处理：
  1. 查看状态：sestatus
  2. 若启用，添加目录访问规则：

  semanage fcontext -a -t tomcat_var_lib_t "/home/rsc/share/tomcat/lib/jw(/.*)?"
  restorecon -Rv /home/rsc/share/tomcat/lib/jw
  

• AppArmor处理：
  1. 编辑/etc/apparmor.d/usr.sbin.tomcat文件，添加目录权限：

  /home/rsc/share/tomcat/lib/jw/** rw,
  /home/rsc/share/tomcat/lib/jw/ rw,
  

  2. 重启AppArmor和Tomcat服务

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