XWiki无法安装扩展及重新初始化问题求助

一、代理配置导致扩展无法加载的排查与修复 #

1. 验证代理参数是否生效
   启动Tomcat后，查看日志文件/opt/apache-tomcat-9.0.64/logs/catalina.out，搜索http.proxyHost或https.proxyHost，确认参数已被正确加载。若未找到，检查catalina.sh中的配置是否存在语法错误（如引号拼接、变量引用问题）。
2. 添加非代理白名单
   避免本地/内部请求走代理，在JAVA_OPTS中补充非代理主机配置：

   -Dhttp.nonProxyHosts="localhost|127.0.0.1|*.yourcompany.internal"
   

   替换*.yourcompany.internal为实际内部域名或IP段。
3. 补充代理认证参数（若需）
   若公司代理要求用户名密码，在JAVA_OPTS中添加：

   -Dhttp.proxyUser=your-proxy-account -Dhttp.proxyPassword=your-proxy-pwd
   -Dhttps.proxyUser=your-proxy-account -Dhttps.proxyPassword=your-proxy-pwd
   

4. 重启Tomcat生效配置
   执行/opt/apache-tomcat-9.0.64/bin/shutdown.sh，等待服务完全停止后再执行startup.sh。

二、手动导入XIP扩展包的正确步骤 #

1. 确认版本匹配
   确保xwiki-platform-distribution-flavor-xip-13.10.8.xip与你安装的XWiki核心版本完全一致，版本不匹配会导致导入无响应。
2. 通过管理界面导入
   • 登录XWiki管理后台，进入应用面板 > 扩展管理器
   • 切换到导入标签页，上传XIP文件完成导入
   • 若上传无反应，检查Tomcat运行用户对webapps/xwiki/data目录的读写权限，执行命令修复：

     chown -R tomcat:tomcat /opt/apache-tomcat-9.0.64/webapps/xwiki/data
     

3. 手动放置扩展包的正确路径
   无需解压XIP包，直接将完整的.xip文件放到XWiki扩展仓库目录：

   /opt/apache-tomcat-9.0.64/webapps/xwiki/data/extensions/repository
   

   放置后重启Tomcat，再进入扩展管理器刷新即可识别扩展。

三、重新初始化XWiki回到安装向导 #

1. 清空数据库
   登录PostgreSQL，执行命令删除并重建XWiki数据库：

   DROP DATABASE xwiki;
   CREATE DATABASE xwiki;
   

   确保数据库用户拥有该库的读写权限。
2. 删除本地数据与配置文件
   • 删除/opt/apache-tomcat-9.0.64/webapps/xwiki/data目录下所有内容（缓存、本地扩展、配置）
   • 删除/opt/apache-tomcat-9.0.64/webapps/xwiki/WEB-INF/hibernate.cfg.xml（安装向导生成的数据库连接配置）
3. 重启Tomcat
   启动Tomcat后访问XWiki地址，即可进入初始安装向导。

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