我是 N8N大学 的主编。在自动化这条路上，代码跑通的瞬间是高光时刻，但报错的红色弹窗更是家常便饭。
很多新手在 n8n 里遇到报错，第一反应是盯着那个红色的节点发呆，或者到处在界面里乱点。其实，看日志是有固定“套路”的。今天，笔者就带你直击 n8n 的“黑匣子”，教你在 30 秒内定位问题根源。
一、问题复现：当你点击“执行”之后
你正在调试一个复杂的 Workflow，点击了“执行”按钮。原本以为会顺畅跑通的数据流，却在某个节点突然卡住。界面弹出一个红色的错误提示，通常伴随着诸如 Execution failed 或具体的 HTTP 状态码（如 400, 500）。
此时，你看到的只是结果，而不是原因。你可能会下意识地重新运行工作流，但问题依旧存在。这种“盲人摸象”的感觉，不仅浪费时间，还容易消磨耐心。
二、原因分析：为什么界面提示不够用？
为什么我们不直接看界面上的提示？因为 n8n 的前端界面对错误信息做了“降噪”处理。为了保持界面的整洁，它往往只显示最核心的错误摘要。
但在底层，n8n 的 Node.js 进程记录了完整的堆栈信息（Stack Trace）、详细的 API 响应体、甚至是网络连接的底层握手细节。如果你只看界面，就像医生只看了你的体温计，却没看血常规报告一样，无法精准诊断。因此，学会看原始日志，是从“小白”进阶“高手”的必修课。
三、解决方案：三步定位法
根据你的 n8n 部署方式不同，查看日志的路径也略有差异。以下是三种最常见场景的解决方案，按推荐程度排序。
1. Docker 部署（最常见）：使用命令行
如果你是通过 Docker Compose 或 Docker Run 部署的 n8n，日志直接就在容器里。这是最硬核、信息最全的方式。
在你的终端中，输入以下命令：
docker logs -f --tail 100 <你的容器名称或ID>
参数解释：
-f: 实时跟随（Follow）日志输出，就像看直播一样。--tail 100: 只显示最后 100 行，避免被历史日志刷屏。
当工作流运行报错时，你会在终端里看到一大段红色的报错信息。重点关注 Error: 开头的行，以及下面的堆栈跟踪。这里往往藏着真正的问题（比如：JSON 格式错误、字段缺失等）。
2. n8n 面板内查看（最快捷）
如果你不想离开浏览器，n8n 本身也提供了日志查看入口，虽然信息量稍逊于终端，但对于排查逻辑错误足够了。
- 登录 n8n 后台。
- 点击左侧菜单栏的 “Executions”（执行历史）。
- 在列表中找到那个红色的、状态为 “Error” 的记录，点击进入。
- 在详情页中，点击 “Error” 标签页。这里会显示具体的错误堆栈和错误信息。
笔者建议：如果是简单的配置错误（如少填了一个参数），看这里就够了；但如果是复杂的网络或依赖问题，还是得回终端看日志。
3. 查看 n8n 日志文件（旧版本或特定配置）
如果你的 n8n 是直接安装在服务器上的（非 Docker），或者你配置了日志文件输出，那么日志通常位于：
~/.n8n/logs/n8n.log
你可以使用 tail 命令查看：
tail -f ~/.n8n/logs/n8n.log
注意：在 Docker 环境下，日志默认输出到 stdout/stderr，不会保存在容器内部的文件中，除非你特意做了挂载映射。
四、避坑指南：日志里的“玄学”
找到了日志，不代表就能立刻看懂。以下是两个常见的日志“陷阱”：
1. 看到 “401 Unauthorized” 不一定是你输错了密码
很多新手看到 401 就去改密码。其实，在 n8n 的 API 节点中，401 往往是因为 Token 过期 或者 Header 头格式不对。检查一下你的 Authorization 头，是不是少了 Bearer 前缀？
2. “Cannot read property ‘x’ of undefined”
这是 JSON 解析的经典错误。意味着你的工作流试图读取一个不存在的字段。比如，你使用了 {{ $json.data.user.id }}，但实际返回的数据里根本没有 data 或 user。这时候，你需要在报错节点前加一个 Set 节点或 IF 节点，先检查数据结构是否存在。
记住：日志是你的朋友，不是敌人。它诚实得甚至有点残酷，但只要你学会了它的语言，它就能带你走出任何自动化迷宫。
FAQ：用户常见问题
Q1：为什么我的日志里全是乱码？
A：这通常是因为编码格式问题，或者日志中包含了二进制数据。在 Docker 日志中，极少出现这种情况。如果出现，尝试检查宿主机的区域设置或日志输出格式。
Q2：日志显示 “Execution timed out” 怎么办？
A：这意味着工作流运行时间超过了 n8n 的默认超时限制（通常为 1 小时）。检查是否有死循环，或者某个节点（如 HTTP Request）等待时间过长。如果是社区版，可以尝试在 Docker 启动命令中增加 --max-execution-time 参数。
Q3：我重启了 Docker，之前的日志还在吗？
A：不在了。Docker 容器重启后，默认会清空之前的日志流。除非你使用了 -v 挂载了持久化日志目录，或者使用了日志收集工具（如 ELK）。所以，建议在报错发生时，第一时间去查看实时日志。
总结与资源
学会看日志，是自动化开发的基石。下次遇到报错，别慌，先打开终端或日志面板，让数据说话。
如果你想更深入地学习 n8n 的故障排查技巧，或者想了解如何搭建高可用的 n8n 集群，欢迎访问 N8N大学 (n8ndx.com)。这里有超过 200 篇实战教程，帮你避过每一个坑。
