Error Messages

This section explains those common error messages you might encounter during developing with ZK, so that you can figure what's going wrong and eliminate them.

Your ZK binary is being altered and may not work as expected

It is caused by mixing unexpected jars in your classpath including :

• Mixing different versions of ZK jar (e.g. 8.6.0.1 with 9.6.0.1)
• Mixing evaluation jar with the official jar

Suggestions

Make sure you use the correct, single source of ZK jar.

• download jar from ZK Maven premium repository
• If you use ZK by copying jar manually, remove all the existing zk jar and copy from a single source again.

The Server is temporarily out of service

The is the default browser-side error message which is displayed after sending an AJAX request.

Runtime Exception

out of sequence

tickets #5785

contentId is required

When you upload a file, you might see this error. This is usually caused by failing to write files into destination media, which could be disk full, lack of writing access to the system temporary folder, or database insertion failure.

Ref:

• https://stackoverflow.com/questions/11366121/contentid-is-required-with-zk-framework
• http://forum.zkoss.org/question/67717/upload-error-contentid-is-required/

The resource you request is no longer available

The resource you request is no longer available: /ui/handling.zul (z_na20). This is normally caused by timeout, or opening too many Web pages. You have to reload the page and try again.

Suggestion

It could be caused by

• the corresponding desktop is gone
• a session was time out
• your server or application is down

Please check them.

client error

Severe: [Desktop z_wew:/mypage.zul] client error: Failed to mount: Cannot read property 'colSpan' of undefined

Suggestion

Usually, a failed to mount error is caused by a bug in the specific widget code, invalid custom javascript, missing javascript packages or files, or other causes affecting the client.

When encountering a failed to mount error box, we suggest you to check:

• Javascript console on a browser

Open a browser developer tools > console tab. You should find one or more javascript errors in the console. Please expand the error stack trace and provide these full error stacks in the support ticket. This can help us pinpoint the exact cause of the issue.

To make the stack trace readable, you have to enable javascript debug mode in zk.xml

<client-config>
<debug-js>true</debug-js>
</client-config>

Restart your zk application.

• Network tab on a browser developer tool

Open a browser developer tools > network tab. ZK does not load every package from page initialization. Instead, packages will be loaded on demand. For example, the zul.inp.wpd (input package) will be loaded if you add an input component to your page. If a browser was unable to locate or load the relevant package for a newly added widget class, you should see a failed request for this package. This request should also display a return code. Anything other than "200 - success" should be documented and added to the support ticket.

Unknown message code: 27112200

tickets#4455

a.b.c-FL requires ZK PE or EE

org.zkoss.lang.SystemException: 9.6.0-FL requires ZK PE or EE