很多用户在WireGuard配置中叠加预共享密钥来增加第二层加密防护时，遇到连通故障往往缺乏标准化的排查记录逻辑，反复核对两端配置却找不到根因，大幅拖慢故障定位效率。这份清单整理了WireGuard预共享密钥排查时应记录的核心信息，覆盖配置属性、关联绑定项、运行现场等多个维度，不管是个人用户还是运维人员都可以对照执行，避免无意义的重复试错操作。
预共享密钥本身的基础属性记录
排查的第一步要同步记录本地端和对等端当前生效的预共享密钥原始值，不能只查看自己侧的配置就默认两端一致，很多场景下对等端管理员之前更新过密钥但没有同步通知，两边存储的密钥字符串从根源上就不匹配，后续所有校验操作都是无效的。
还要记录密钥的生成方式和生成时间，手动输入生成的密钥要确认复制过程中有没有误带多余的空格、换行符，通过wg genkey工具自动生成的密钥要留存当时的终端输出日志，避免排查时误以为密钥是完整的32位base64字符串，实际复制阶段意外截断了末尾几个字符。
WireGuard基础配置关联项记录
接下来要记录预共享密钥绑定的对等端公钥信息，WireGuard的预共享密钥并非全局生效，而是和特定Peer段下的对等端公钥一一绑定，不少用户排查时搞错了对应关系，把A对等端的预共享密钥填到了B对等端的配置字段里，哪怕密钥本身完全正确也无法完成校验。
还要记录配置文件里预共享密钥行的具体位置和周边注释内容，部分用户习惯在配置文件里添加大量自定义注释，偶尔会不小心把PresharedKey配置行写到Interface段而不是对应的Peer段内，这类位置错误如果没有留存原始配置的行结构信息，排查很久都找不到问题所在。
同时要记录当前WireGuard接口的运行模式，确认是内核模块驱动运行还是用户态wireguard-go模式运行，部分老旧版本的用户态实现对预共享密钥的字符校验规则和官方内核版本存在细微差异，这类环境信息如果没有提前留存，很容易把版本兼容问题误判为密钥本身输入错误。
故障现场的运行状态日志记录
排查时要第一时间用wg show命令输出完整的接口运行状态，重点记录预共享密钥对应对等端的最新握手时间，如果握手时间始终没有更新，大概率是密钥不匹配或者对应公钥绑定错误，而不是底层公网连通性存在问题。
还要同步提取WireGuard服务最近的系统日志和内核报错信息，部分Linux发行版的系统日志会直接输出预共享密钥校验失败的明确提示，很多用户排查时习惯性跳过日志查看，反复重新生成新密钥做大量无用操作。
另外要记录故障发生前后的所有配置变更记录，比如之前有没有更新过WireGuard软件版本、有没有替换过对等端的公钥，很多时候预共享密钥故障是伴随其他配置改动出现的关联问题，单独盯着密钥本身反复校验很难找到真实根因。
边界场景下的关联排查信息记录
如果当前网络环境里部署了多层VPN嵌套或者中间有流量安全设备，要记录完整的端到端网络拓扑，部分深度报文检测设备虽然不会篡改WireGuard的密钥校验报文，但如果中间设备存在异常的流量改写行为，也会导致密钥校验始终无法通过，这类拓扑信息如果没有留存，很容易把网络干扰误判为密钥配置错误。
最后要记录排查过程中做过的所有对照验证操作的结果，比如临时替换成无预共享密钥的配置能不能正常连通，替换成新生成的测试密钥能不能完成握手，这些对照结果可以快速排除底层网络层面的干扰，把问题范围缩小到预共享密钥本身的配置环节。
