Kong插件调试踩坑总结
最近在公司项目中引入Kong作为API网关，过程中遇到了不少plugin调试的坑，特此记录。
问题1：自定义插件无法加载
按照官方文档编写了一个简单的日志插件，但在Kong启动时总是提示module 'kong.plugins.my-plugin' not found。经过排查发现，插件文件路径必须严格按照Kong的插件目录结构：/opt/kong/plugins/my-plugin/，而且需要在kong.conf中添加plugins = bundled,my-plugin。
问题2：插件配置不生效
调试过程中发现虽然插件加载成功了，但配置项总是不生效。通过查看Kong的请求日志发现，插件中的access()方法确实被调用了，但是配置读取有问题。最终发现是配置字段名与schema定义不一致导致的，必须严格按照schema中的字段名进行配置。
问题3：调试困难
在Kong中调试插件确实是个挑战。之前使用print()调试，但Kong的日志级别默认较高，需要在kong.conf中设置log_level = debug，然后通过docker logs kong-container查看输出。
问题4：性能影响
测试阶段发现启用插件后API响应时间明显增加。通过kong.log分析发现是插件中的数据库查询操作阻塞了请求。优化方案是在插件中使用缓存机制，并将数据库查询移到启动时预加载。
实用调试命令
# 查看插件状态
kong plugins
# 重启Kong服务
kong restart
# 查看详细日志
kong logs --level debug
建议在生产环境部署前，一定要在测试环境中充分验证插件的稳定性和性能影响。
讨论