适合切换节点后内核立即退出、升级后无法启动，以及导入自定义配置后报错的 v2rayN 用户。按“保留日志、确认启动阶段、找到最内层错误、修改来源配置、重新验证”的顺序排查，先恢复本地监听，再检查远端连接，避免把所有故障都归为节点不可用。
先分清：内核没启动，还是启动后连接失败
v2rayN 是图形客户端，负责管理节点、生成配置并调用内核；Xray 负责读取配置、建立监听和处理连接。客户端窗口能打开，不代表 Xray 已正常运行。系统代理已开启，也只说明系统代理地址被设置，不代表对应端口真的有进程监听。
排查时先暂时关闭系统代理，避免浏览器继续连接失效的本地端口。Windows 桌面界面通常可从托盘菜单「系统代理」选择「清除系统代理」。随后打开主窗口下方的信息或日志区域，清理旧显示后，只执行一次启动或重启内核。不同界面版本的按钮名称可能不同，应以当次启动产生的日志为准。
| 观察到的现象 | 优先判断 | 下一步 |
|---|---|---|
| 进程没有创建，提示找不到文件 | 启动路径或安装内容异常 | 检查实际调用的内核路径 |
| 出现配置错误，随后进程退出 | JSON、协议字段或资源加载失败 | 读取错误链最后一层 |
| 出现 bind 错误 | 本地监听端口无法绑定 | 查询端口占用与监听地址 |
| 有启动信息与本地监听，请求才报错 | 通常进入连接阶段 | 检查节点地址、TLS 和路由 |
例如 connection refused、i/o timeout 或 TLS 握手失败，若发生在发起网页请求之后，通常不是配置加载阶段的故障。先确认日志时间和本地端口状态，不要仅凭一个英文关键词判断内核启动失败。
读日志：保留错误链，不只复制最后一句
Xray 的错误经常逐层包装。外层可能只说 Failed to start，中间指向配置文件，内层才说明某个端口、协议字段或资源文件有问题。日志中的 > 常用于连接这些错误原因，不是需要输入的命令。
- 记录环境：在客户端「帮助」→「关于」或对应版本信息入口记录 v2rayN 版本；从启动日志记录 Xray 版本。不要把客户端版本当成内核版本。
- 保留完整的一次启动：从调用内核的第一行开始，保存到退出提示；不要把连续多次重试混在一起。
- 定位最具体的信息：搜索
bind、invalid、failed to load、not found，同时查看前后几行。 - 区分配置来源：确认当前选择的是普通节点，还是自定义配置。前者应优先修改节点编辑窗口和客户端设置，后者需要检查实际加载的 JSON 文件。
如果当前日志过少，可在「设置」→「参数设置」查找日志等级选项，临时改为 info 后重启一次。仍无法定位时再短时使用 debug。调试日志可能包含访问目标，排查结束应恢复原等级，不要长期记录并公开上传。
端口占用：先找进程，再改本地监听
端口占用发生在本地，与远端服务器是否在线无关。常见情形是启动了两份 v2rayN、旧内核仍在运行，或另一个程序使用了同一监听地址与端口。下面的 10808 仅作示例，实际排查必须替换为日志中的端口。
报错：bind: address already in use
原因：在出现该提示的系统上，目标地址与端口已被其他监听占用。
解法：查询占用进程，正常退出重复实例；若端口必须留给其他程序，就修改 v2rayN 本地监听端口。
报错：Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因：这是 Windows 常见的套接字绑定冲突提示，通常伴随具体的监听地址。
解法：核对日志中的地址和端口，并检查是否有绑定到所有地址的程序占用了同一端口。
Windows 可打开 PowerShell，先查询监听及其所属进程。下列命令只查看信息，不会终止进程：
Get-NetTCPConnection -State Listen -LocalPort 10808 -ErrorAction SilentlyContinue |
Select-Object LocalAddress, LocalPort, OwningProcess
Get-NetTCPConnection -State Listen -LocalPort 10808 -ErrorAction SilentlyContinue |
ForEach-Object { Get-Process -Id $_.OwningProcess }确认占用者是重复启动的客户端后，通过它自己的退出入口关闭，不要直接结束身份不明的系统进程。如果决定把监听端口从 10808 改为 10818，在「设置」→「参数设置」中查找本地监听端口；部分版本将其显示为本地混合监听端口。保存并重启内核，再更新手动填写代理地址的应用。
结论：改端口必须同步代理入口
内核改到 127.0.0.1:10818 后，仍指向 127.0.0.1:10808 的应用不会自动跟随。确认新端口正在监听后，再重新设置系统代理，并核对应用内的手动代理配置。
JSON 语法错误：先修结构，再看协议含义
JSON 解析失败意味着内核还没有进入正常连接流程。普通节点由 v2rayN 生成运行配置，手动编辑生成文件通常会被下次启动覆盖；应回到节点编辑窗口或相关设置修改来源。只有使用自定义配置时，才应直接检查被加载的 JSON 文件。
报错：invalid character '}' looking for beginning of object key string
原因：对象末项后多出的逗号等语法问题，可能让解析器在期待下一个键名时遇到右花括号。
解法：检查报错附近及前一项，删除末尾多余逗号，并确认键名使用英文双引号。
报错：unexpected EOF
原因：读取提前结束，常见于文件被截断、引号未闭合或括号缺失。
解法：核对文件末尾与括号配对；若内容不完整，从可信的原始配置重新导出，不要盲目补括号。
下面只展示 log 配置的语法，不是可直接代理流量的完整配置。错误示例在 "warning" 后多了一个逗号：
{
"log": {
"loglevel": "warning",
}
}对应的合法 JSON 写法如下。中文弯引号不能替代英文双引号；JSON 数值和布尔值也不应随意改成字符串。
{
"log": {
"loglevel": "warning"
}
}- 先语法、后语义：通过 JSON 解析只能证明结构可读，不能证明协议、传输层与服务端匹配。
- 谨慎对待行号：日志指向的位置可能是解析器发现问题的位置，真正的错误也可能在上一行。
- 避免在线粘贴配置：含凭据的配置应在本机检查，不要上传到公开的格式化工具。
协议字段缺失：回到节点编辑窗口修改
JSON 能读取后，Xray 还会校验协议与传输配置。VMess、VLESS、Trojan 的身份字段并不相同，不能仅修改协议名称就完成转换。VLESS 常见的用户标识是 UUID，Trojan 使用密码；TLS、REALITY、传输方式和 flow 也必须与服务端约定相符。
报错：invalid UUID
原因：需要 UUID 的用户字段为空、格式错误，或混入了复制时带入的字符。
解法：在主列表打开当前节点的编辑窗口，核对用户 ID；从原始节点信息重新复制，删除首尾空白后保存。
| 日志线索 | 检查内容 | 修改位置 |
|---|---|---|
| 用户标识解析失败 | VMess、VLESS 的 UUID 是否完整 | 当前节点编辑窗口的用户 ID |
| 地址或端口相关错误 | 服务器地址非空，远端端口在 1–65535 内 | 当前节点的地址与端口 |
| 安全层或传输配置构建失败 | 安全类型、传输类型及配套字段是否受当前内核支持 | 节点编辑窗口对应设置页 |
| flow 或 REALITY 字段相关错误 | 是否与服务端提供的参数一致 | 节点的流控与安全层设置 |
没有报启动错误，也不等于所有字段都正确。例如 TLS 的服务器名称与证书不匹配，往往要到连接远端时才会暴露。不要通过开启跳过证书验证来掩盖问题；应先核对设备时间、服务器名称和服务端证书。REALITY 需要按对应版本与服务端要求填写认证参数，不能直接套用普通 TLS 配置。
订阅节点修改后，后续更新可能重新导入来源参数。若只为定位问题，可先复制一份节点用于本地测试，并明确标记用途；确认是源数据问题后再修正订阅来源。不要把临时修正误当成订阅长期生效的设置。
内核文件与规则文件缺失：按日志路径恢复
找不到 Xray 可执行文件时，失败通常发生在创建进程阶段；找不到 geoip.dat 或 geosite.dat 时，则可能是进程已经运行，但加载引用这些资源的路由规则失败。这两种情况需要分别处理，不能都靠更新订阅解决。
报错：The system cannot find the file specified.
原因：Windows 启动进程时找不到所引用的文件；需要结合前文路径判断是否为内核文件。
解法：核对启动日志中的可执行文件路径，确认安装包完整解压、目录未被移动，并检查安全软件的隔离记录。
报错：failed to load geosite
原因：可能是规则文件缺失、不可读，或规则引用了文件内不存在的分类；仅凭这段前缀不能确定是哪一种。
解法：继续读取后续错误，分别核对资源路径、读取权限与分类名，再恢复对应规则数据或修正路由引用。
- 核对安装方式：使用压缩包时，完整解压到正常目录后再启动，不要只从压缩包中打开主程序。
- 核对架构：选择与系统架构一致的安装包和内核。架构不匹配可能表现为无法执行，而不是文件缺失。
- 核对安全软件记录：先确认文件来源与隔离原因，再按系统流程处理。不要把关闭整个防护作为常规排错步骤。
- 核对路由资源：若日志指出规则分类不存在，更新规则数据或修正规则分类名；文件存在不代表它含有所需分类。
需要恢复安装内容时，可前往客户端下载页按平台选择安装包。先备份自己维护的配置，再恢复程序文件；不要在排错过程中随意删除整个用户数据目录。普通文件缺失也不应优先用管理员权限掩盖，只有日志明确指出权限相关问题时，才针对具体路径处理。
修复后验证：一次只改一项
每修复一项，就重新启动并保存新日志。先确认配置加载成功，再确认本地监听，最后通过应用发起一次请求。这样可以区分“原来的启动错误已解决”和“随后出现了新的远端连接问题”。两个问题可能同时存在，但不应一次改动端口、协议、DNS 和路由。
- 第一步：确认同一次启动日志中没有紧随其后的致命错误或进程退出；不要只看见启动提示就停止检查。
- 第二步：用前面的 PowerShell 命令查询实际端口，确认监听进程确实属于本次启动的内核。
- 第三步：恢复系统代理，检查浏览器或目标应用使用的代理入口，再发起一次请求并观察日志。
- 第四步：若仅出现连接超时或握手错误，转向远端参数排查，不再反复修补已经通过加载的 JSON 结构。
窗口能打开，为什么还提示内核启动失败？
图形界面与内核是不同进程。打开日志区域，查找本次调用 Xray 后的具体错误，再检查对应本地端口是否监听；界面可操作不能代替内核状态判断。
把 10808 改成 10818 后，为什么网页仍打不开？
先确认新端口已监听，再重新设置系统代理。对于应用中手动填写的代理，将端口同步改为 10818，并确认它选择的代理类型与监听入口兼容。
直接修改运行时 JSON，重启后为什么又变回去了？
普通节点的运行配置由 v2rayN 重新生成。回到当前节点编辑窗口或「设置」→「参数设置」修改源选项；只有明确使用自定义配置时才维护对应文件。
切换内核后能启动，是否就算修好了？
还需核对协议和字段支持情况。不同内核的配置能力并不完全相同；记录切换前后的版本与错误，只保留与节点参数匹配的配置，不要把切换当成字段错误的通用修复。
最终应留下三项明确结果：使用哪个版本的内核、哪一项配置导致失败、修改后哪个端口成功监听。它们比“重装后好了”更有复用价值，也方便下一次升级、导入订阅或调整路由时快速回溯。