XWiki知识库使用手册

启动程序

1、在超腾开源商城中购买XWiki知识库后，在我的订单页面下载 xwiki-basic-cn.zip 到电脑，输入解压密码解压。

2、双击 start_xwiki.bat 启动，等出现以下界面说明启动成功。

3、在浏览器中访问 http://localhost:8080/ 即可。

说明：上图为XWiki知识库基础版，下图为XWiki知识库专业版。

用户登录

1、点击右上角登录按钮会跳转登录页面，输入用户名和密码进行登录。

默认用户名：Admin
默认密码：admin

2、点击右上角菜单按钮，选择管理Wiki，可以对Wiki进行设置。

常见问题

XWiki常见问题：https://www.hylab.cn/wiki/常用软件/XWiki

1、启动报错：java.io.IOException: Failed to bind to 0.0.0.0/0.0.0.0:8080. Caused by: java.net.BindException: Address already in use: bind.

解决方法：8080端口被占用，编辑 start_xwiki.bat，找到 set JETTY_PORT=8080 一行，改成其他端口即可。

2、启动有警告：Error binding ShutdownMonitor to port 8079: java.net.BindException: Address already in use: bind.

解决方法：8079端口被占用，参考上图，把8079改成其他端口即可。

2、在管理Wiki、内容、导入中导入export-20260218.xar报错：Failed to import documents. Reason: Bad Request

查看网络请求详细日志：

Caused by: org.eclipse.jetty.http.BadMessageException: 400: Unable to parse form content
	at org.eclipse.jetty.ee8.nested.Request.getParameters(Request.java:373)
	at org.eclipse.jetty.ee8.nested.Request.getParameterMap(Request.java:876)
	at javax.servlet.ServletRequestWrapper.getParameterMap(ServletRequestWrapper.java:158)
	at org.xwiki.container.servlet.filters.internal.SavedRequestRestorerFilter$SavedRequestWrapper.getParameterMap(SavedRequestRestorerFilter.java:165)
	at org.xwiki.wysiwyg.internal.filter.http.MutableHttpServletRequest.<init>(MutableHttpServletRequest.java:58)
	at org.xwiki.wysiwyg.internal.filter.http.MutableHttpServletRequestFactory.newInstance(MutableHttpServletRequestFactory.java:43)
	at org.xwiki.wysiwyg.internal.converter.DefaultRequestParameterConverter.convert(DefaultRequestParameterConverter.java:110)
	at org.xwiki.wysiwyg.internal.converter.DefaultRequestParameterConverter.convert(DefaultRequestParameterConverter.java:96)
	at org.xwiki.wysiwyg.filter.ConversionFilter.doFilter(ConversionFilter.java:58)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:171)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.xwiki.container.servlet.filters.internal.SetHTTPHeaderFilter.doFilter(SetHTTPHeaderFilter.java:63)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:171)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.xwiki.resource.servlet.RoutingFilter.doFilter(RoutingFilter.java:132)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:171)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.xwiki.container.servlet.filters.internal.SavedRequestRestorerFilter.doFilter(SavedRequestRestorerFilter.java:209)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:171)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.xwiki.container.servlet.filters.internal.SetCharacterEncodingFilter.doFilter(SetCharacterEncodingFilter.java:117)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:177)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.eclipse.jetty.ee8.websocket.servlet.WebSocketUpgradeFilter.doFilter(WebSocketUpgradeFilter.java:175)
	at org.eclipse.jetty.ee8.servlet.FilterHolder.doFilter(FilterHolder.java:171)
	at org.eclipse.jetty.ee8.servlet.ServletHandler$Chain.doFilter(ServletHandler.java:1348)
	at org.eclipse.jetty.ee8.servlet.ServletHandler.doHandle(ServletHandler.java:454)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.handle(ScopedHandler.java:119)
	at org.eclipse.jetty.ee8.security.SecurityHandler.handle(SecurityHandler.java:497)
	at org.eclipse.jetty.ee8.nested.HandlerWrapper.handle(HandlerWrapper.java:108)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.nextHandle(ScopedHandler.java:183)
	at org.eclipse.jetty.ee8.nested.SessionHandler.doHandle(SessionHandler.java:519)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.nextHandle(ScopedHandler.java:181)
	at org.eclipse.jetty.ee8.nested.ContextHandler.doHandle(ContextHandler.java:881)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.nextScope(ScopedHandler.java:152)
	at org.eclipse.jetty.ee8.servlet.ServletHandler.doScope(ServletHandler.java:423)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.nextScope(ScopedHandler.java:150)
	at org.eclipse.jetty.ee8.nested.SessionHandler.doScope(SessionHandler.java:503)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.nextScope(ScopedHandler.java:150)
	at org.eclipse.jetty.ee8.nested.ContextHandler.doScope(ContextHandler.java:826)
	at org.eclipse.jetty.ee8.nested.ScopedHandler.handle(ScopedHandler.java:117)
	at org.eclipse.jetty.ee8.nested.ContextHandler.handle(ContextHandler.java:1424)
	at org.eclipse.jetty.ee8.nested.HttpChannel$RequestDispatchable.dispatch(HttpChannel.java:1290)
	at org.eclipse.jetty.ee8.nested.HttpChannel.dispatch(HttpChannel.java:623)
	at org.eclipse.jetty.ee8.nested.HttpChannel.handle(HttpChannel.java:460)
	at org.eclipse.jetty.ee8.nested.ContextHandler$CoreContextHandler$CoreToNestedHandler.handle(ContextHandler.java:2385)
	at org.eclipse.jetty.server.handler.ContextHandler.handle(ContextHandler.java:1060)
	at org.eclipse.jetty.server.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:181)
	at org.eclipse.jetty.server.Server.handle(Server.java:182)
	at org.eclipse.jetty.server.internal.HttpChannelState$HandlerInvoker.run(HttpChannelState.java:662)
	at org.eclipse.jetty.server.internal.HttpConnection.onFillable(HttpConnection.java:418)
	at org.eclipse.jetty.io.AbstractConnection$ReadCallback.succeeded(AbstractConnection.java:322)
	at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:99)
	at org.eclipse.jetty.io.SelectableChannelEndPoint$1.run(SelectableChannelEndPoint.java:53)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.runTask(AdaptiveExecutionStrategy.java:478)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.consumeTask(AdaptiveExecutionStrategy.java:441)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.tryProduce(AdaptiveExecutionStrategy.java:293)
	at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.run(AdaptiveExecutionStrategy.java:201)
	at org.eclipse.jetty.util.thread.ReservedThreadExecutor$ReservedThread.run(ReservedThreadExecutor.java:311)
	at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:979)
	at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.doRunJob(QueuedThreadPool.java:1209)
	at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.run(QueuedThreadPool.java:1164)
	at java.base/java.lang.Thread.run(Thread.java:1583)
Caused by: java.lang.IllegalStateException: Form with too many keys [2001 > 2000]
	at org.eclipse.jetty.util.UrlEncoded.checkMaxKeys(UrlEncoded.java:755)
	at org.eclipse.jetty.util.UrlEncoded.decodeUtf8To(UrlEncoded.java:556)
	at org.eclipse.jetty.util.UrlEncoded.decodeTo(UrlEncoded.java:661)
	at org.eclipse.jetty.ee8.nested.Request.extractFormParameters(Request.java:489)
	at org.eclipse.jetty.ee8.nested.Request.extractContentParameters(Request.java:456)
	at org.eclipse.jetty.ee8.nested.Request.getParameters(Request.java:370)
	... 62 more

解决方法：编辑文件 xwiki-basic-cn\webapps\xwiki\WEB-INF\jetty-web.xml 和 xwiki-basic-cn\webapps\xwiki\WEB-INF\jetty-ee8-web.xml，把 maxFormContentSize和maxFormKeys 的值改得更大一些，然后重启程序。

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
  <Set name="maxFormContentSize">10000000</Set>
  <Set name="maxFormKeys">200000</Set>
</Configure>