20150317 Update：增加 appium 官方 issue 和讨论组的链接
很高兴最近论坛用 appium 的人多了不少，但也有不少由于不了解 appium 导致出现错误后不知道从何下手。这里根据我的个人经验给出一个简单的查错指南，不保证能解决所有错误，但至少让你知道你应该朝哪个方向去解决。
这是很多人忽略但却是最重要的方法。Appium 的文档说明了 如何正确使用 appium 和 有哪些事情 appium 做不了或者要通过特殊方法做。大部分刚入门的同学的问题在这里面都能找到答案。
中文文档（由 testerhome 开源团队翻译，目前已和官方文档一致）：https://github.com/testerhome/appium/tree/master/docs/cn
英文文档：https://github.com/appium/appium/tree/master/docs/en
Appium 的 log 默认使用 debug 级别，所以内容很丰富。如果你懂得正确地阅读，你能很容易地从 google/stackoverflow 找到答案。
PS：不建议用百度。百度搜出来的其实大多都是 testerhome 的……
由于 Appium 的主要结构为：
Android：使用 adb 管理设备及安装应用，使用 UiAutomator/selendriod 驱动对应用的各种操作（找元素、点击等）
iOS：使用 Instruments 管理设备，使用 UiAutomation 驱动对应用的各种操作
因此 Appium 的 log 主要有以下几类：
1、 网络通讯 log（以-->或<--符号开头）：
info: --> GET /wd/hub/status {}
info: <-- GET /wd/hub/status 200 1.335 ms - 104 {"status":0,"value":{"build":{"version":"1.3.4","revision":"c8c79a85fbd6870cd6fc3d66d038a115ebe22efe"}}}
此类 log 一般出现在 Appium client 与 Appium server 通信时，记录原始通信信息。一般出错只是因为下面执行出错然后反馈到上层（出错的话请看 http status code。如上面的状态码是 200，即处理成功）。
2、 Appium Server 内部处理 log（以类似[debug]的 log 级别开头，相比下面其他类型的 log 没有其他特别标志 ）：
info: [debug] Responding to client with success: {"status":0,"value":{"build":{"version":"1.3.4","revision":"c8c79a85fbd6870cd6fc3d66d038a115ebe22efe"}}}
...
info: [debug] Configuring Safari session
info: [debug] We're on iOS8+ so not copying mobile safari app
info: [debug] Creating new appium session 59f933a1-ee07-45d3-bbec-cabfe89735d8
info: [debug] Removing any remaining instruments sockets
info: [debug] Cleaned up instruments socket /tmp/instruments_sock
info: [debug] Setting Xcode folder
此类 log 是 appium server 内部 log，出现频率最高，用于说明此时 Appium server 内部正在做什么（调用其他工具、创建会话等）。如果这里出错且无下面三类错误，那是 appium server 的错误。
3、 Apple Instruments log（log 内容中有额外时间戳。如果用.app 看，log 颜色为绿色）：
info: [debug] [INST] 2015-03-13 23:31:59 +0000 Debug: evaluation finished
info: [debug] [INST] 2015-03-13 23:31:59 +0000 Debug: responding with:
info: [debug] [INST] 2015-03-13 23:31:59 +0000 Debug: Running system command #1: /Applications/Appium.app/Contents/Resources/node/bin/node /Applications/Appium.app/Contents/Resources/node_modules/appium/node_modules/appium-uiauto/bin/command-proxy-client.js /tmp/instruments_sock 2,{"status":0,"value":true}...
此类 log 为 Instruments 的 log，Appium 只是为了让大家方便查看而附在 appium log 里面。此类 log 出错请找 Instruments。
4、 Android UiAutomator log（以[UIAUTOMATOR STDOUT]或[BOOTSTRAP]开头）：
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: numtests=1
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: stream=
info: [debug] [UIAUTOMATOR STDOUT] io.appium.android.bootstrap.Bootstrap:
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: id=UiAutomatorTestRunner
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: test=testRunServer
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: class=io.appium.android.bootstrap.Bootstrap
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS: current=1
info: [debug] [UIAUTOMATOR STDOUT] INSTRUMENTATION_STATUS_CODE: 1
info: [debug] [BOOTSTRAP] [debug] Socket opened on port 4724
info: [debug] [BOOTSTRAP] [debug] Appium Socket Server Ready
info: [debug] [BOOTSTRAP] [debug] Loading json...
此类 log 为 UiAutomator 的 log。其中[UIAUTOMATOR STDOUT]是启动 UiAutomatorTestRunner 的 log，[BOOTSTRAP]是 Appium 装在被测设备上的 BOOTSTRAP 工具的 log（由于 UiAutomator 必须在 Android 系统上运行，所以 Appium 做了一个特殊的 UiAutomator 的测试用例在被测设备上接收 Appium 命令并执行命令）。此处 log 出错请找 UiAutomator（虽然 BootStrap 也是 Appium 的一部分，但一般是调用 UiAutomator API 时出错）。
5、 Selendroid log（以[SELENDROID]开头）:
info: [debug] [SELENDROID] mSeq=0 mSystemUiVisibility=0x0
info: [debug] [SELENDROID] mSystemDecorRect=[0,38][480,728] last=[0,38][480,728]
此类 log 为 Selendroid 内部处理的 log。此处出错请找 Selendroid。
issue：https://github.com/appium/appium/issues
讨论组：https://discuss.appium.io/
testerhome：http://testerhome.com/