如何在Azure WebApps上部署XWiki？遇404错误求助

可以在Azure Web Apps部署XWiki，但默认的Docker Compose配置是为本地环境设计的，必须针对Azure的容器服务规则、数据库要求调整配置才能正常运行，以下是针对性的解决步骤：

1. 调整容器端口与Tomcat监听配置 #

Azure Web Apps仅对外暴露80/443端口，而XWiki镜像默认使用8080端口，需修改Tomcat配置切换到80端口：

• 编辑Tomcat的server.xml，将<Connector port="8080"替换为<Connector port="80"，确保协议为HTTP/1.1
• 在自定义Dockerfile中添加EXPOSE 80，或启动时通过环境变量指定：CATALINA_OPTS="-Dhttp.port=80"

2. 替换容器内MySQL为Azure托管MySQL服务 #

Azure Web Apps的容器组不适合运行状态化数据库，稳定性和可靠性不足，必须改用Azure Database for MySQL：

• 登录Azure门户创建Azure Database for MySQL实例，配置防火墙规则允许Azure Web Apps的出站IP访问
• 修改hibernate.cfg.xml中的数据库连接参数：

  <property name="connection.url">jdbc:mysql://<Azure MySQL服务器名>.mysql.database.azure.com:3306/<数据库名>?useSSL=true&requireSSL=false</property>
  <property name="connection.username"><Azure MySQL用户名>@<服务器名></property>
  <property name="connection.password"><数据库密码></property>
  

3. 修正XWiki上下文路径与Base URL #

404错误大概率是因为XWiki默认上下文路径为/xwiki，而Azure Web Apps默认从根路径访问：

• 修改xwiki.cfg中的xwiki.webapppath参数为xwiki.webapppath=/
• 设置环境变量XWIKI_BASE_URL=https://<你的Web Apps域名>，确保XWiki生成的内部链接适配Azure域名

4. 构建自定义镜像并部署 #

不要直接使用官方镜像，需基于官方镜像构建自定义镜像整合上述配置：

FROM xwiki:<你的版本号>-mysql-tomcat
# 修改Tomcat监听端口为80
RUN sed -i 's/port="8080"/port="80"/g' /usr/local/tomcat/conf/server.xml
# 替换自定义的hibernate配置文件
COPY hibernate.cfg.xml /usr/local/xwiki/WEB-INF/hibernate.cfg.xml
# 调整XWiki上下文路径为根目录
RUN sed -i 's/xwiki.webapppath=.*/xwiki.webapppath=\/\//g' /usr/local/xwiki/xwiki.cfg
EXPOSE 80

• 构建镜像后推送到Azure容器注册表，再部署到Web Apps
• 在Web Apps的「应用设置」中添加数据库连接相关的环境变量（推荐用此方式而非固化到镜像，便于后续修改）

5. 配置数据持久化 #

使用Azure Files挂载XWiki的数据目录，避免容器重启后数据丢失：

• 在Azure门户创建存储账户和文件共享
• 在Web Apps的「配置」-「路径映射」中添加存储挂载，将Azure Files共享挂载到容器内的/usr/local/xwiki路径

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