插件加载失败主因是构建方式错误或导出符号不合规：必须用go build -buildmode=plugin编译，且导出函数如NewAdapter()须首字母大写、在非main包中定义；路径需为绝对路径，Linux下还需chmod +x；Windows完全不支持，plugin: not implemented on windows为硬性限制。
插件加载失败：找不到协议适配器入口函数
GoLand 本身不参与插件运行时加载，但开发阶段若 plugin.Open() 报错 "plugin: not implemented on linux/amd64" 或 "symbol not found: NewAdapter"，说明插件构建方式不对。Go 的 plugin 包仅支持 Linux/macOS，且要求插件必须用 buildmode=plugin 编译，且导出符号必须是首字母大写的函数或变量。
- 确保插件源码中定义了可导出的工厂函数，例如：
func NewAdapter() protocol.Adapter，不能是newAdapter() - 编译插件时必须显式指定模式：
go build -buildmode=plugin -o mqtt_adapter.so ./plugins/mqtt - 主程序调用前，确认
plugin.Open("mqtt_adapter.so")的路径是绝对路径或相对于当前工作目录的正确路径——GoLand 默认工作目录是项目根目录，不是main.go所在目录 - 插件内禁止使用
init()里触发网络连接或阻塞操作，否则plugin.Open()会卡死
协议插件热加载后状态不一致
常见现象是设备重连后消息路由到旧 adapter 实例，或 deviceService 被重复初始化。根本原因在于插件热加载未清理旧实例引用，也未同步更新全局协议路由表。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 不要把 adapter 实例缓存在包级变量里（如
var currentMqttAdapter protocol.Adapter），而应由主程序统一管理生命周期 - 每次
plugin.Close()前，必须主动通知 adapter 释放资源：调用其Shutdown(ctx)方法（需约定接口），尤其要关闭net.Listener和 goroutine - 路由分发层（如
protocol.Router）必须用读写锁保护，LoadPlugin()和dispatch()不能并发修改同一张 map - 设备连接上下文（如
conn）不能跨插件复用；新插件加载后，已有连接需按协议重新协商，不能强行“套用”旧 adapter 的 session 状态
GoLand 调试插件时断点失效
GoLand 对 plugin 模块的调试支持有限：符号表缺失、断点跳过、变量无法展开。这不是 IDE Bug，而是 Go plugin 机制本身限制——插件代码不参与主程序编译期符号生成。
- 调试插件逻辑前，先用
dlv exec启动主程序，并在命令行加--headless --listen=:2345，再用 GoLand 的 “Attach to Process” 连接 dlv，比直接 Run/Debug 更可靠 - 插件内部日志必须用
log.Printf或结构化 logger 输出到 stderr，GoLand 的 Console 面板能捕获；避免只写文件，否则调试时看不到实时输出 - 在插件导出函数（如
NewAdapter）开头强制 panic 一句，验证是否真被加载成功：“panic("mqtt adapter loaded")”——这是最快速的加载通路验证法 - 禁用 GoLand 的 “Build before run” 自动构建，因为插件需单独构建；改用 External Tools 配置两个命令：一个构建主程序，一个构建指定插件
插件间共享设备状态引发竞态
多个协议插件（如 MQTT + CoAP）同时更新同一台设备的在线状态或 last_seen 时间戳，容易出现覆盖写或丢失更新。底层存储若用 map[string]*Device 加锁，性能差且易漏锁。
- 设备状态必须走统一仓储接口
device.Store，且所有写操作封装为原子方法，例如：store.UpdateOnlineStatus(deviceID, true)，内部用sync.Map或带版本号的 CAS 更新 - 禁止插件直接读写全局 map；如果必须缓存，用
device.Cache.Get(deviceID)，且该 cache 底层应基于sync.RWMutex+ LRU 控制大小 - HTTP 插件上报传感器数据、MQTT 插件下发控制指令，都应通过 domain 层的
deviceService.ReportData()或deviceService.SendCommand()中转，而非绕过业务逻辑直写 store - 注意 GoLand 的 “Evaluate Expression” 功能在调试时可能触发非线程安全的 map 遍历，导致 panic；查状态优先用日志打点，而不是临时表达式求值
