Troubleshooting

This page aims to act as a reference for issues that may be encountered when using the Inspector.

Cannot open the app after installation¶

Cannot start a session using plugin version¶

The reason for this issue is cross-origin resource sharing (CORS). The browser will prevent you from connecting to the Appium server if the base URLs of the Inspector and the Appium server do not match (typically 127.0.0.1).

If you want to access the Inspector using another base URL (such as localhost), you can do so by adding the --allow-cors flag when starting the server:

appium --use-plugins=inspector --allow-cors

This will instruct the server to sent the correct CORS-related headers, and it should be possible to create a session.

Note

If you encounter this issue with a cloud provider, the fix must be applied on the provider side, because they are the ones hosting the Appium server.

Start Session button is cut off¶

This problem may appear if your computer screen size is too small. Check the System Requirements for more details.

Cannot see full source tree with XCUITest driver + React Native app¶

This is a known issue. The problem is caused by Apple's XCTest framework, so unfortunately it cannot be resolved from the Appium side. However, there are a few suggestions that may help mitigate this:

Set the snapshotMaxDepth setting to 62 (the maximum stable value)
Configure the pageSourceExcludedAttributes setting to exclude some attributes that you may find less relevant (e.g. "visible,accessible")
Set the customSnapshotTimeout setting to a higher value

If these do not help, then the only remaining solution is to work with the app developers to refactor the application code. Some suggestions from the linked issue thread include:

Try to remove unnecessary nesting levels
Use the Fabric renderer with View Flattening
Use native stack navigator instead of stack navigator
Reduce the amount of view tags/test IDs