社区模块对接踩过的坑：发帖、回帖、积分接口联调手记

最近在把内容社区和积分体系打通，发现“发帖—回帖—积分入账”这条链路看着简单，联调时却处处是细节。背景是社区模块本身已有发帖、回帖接口，积分模块提供加减分接口，两边独立开发、各自能跑，一对接问题就冒出来了。

分享几点经验：

一、发帖与积分要解耦。发帖接口只负责内容落库和返回帖子ID，积分入账走异步或事件触发，避免积分服务抖动导致发帖失败。同步调用看似省事，一出错用户内容就白写了。

二、回帖防刷要在积分侧兜底。社区侧做频率限制，积分侧仍要按“用户+帖子+动作”做幂等，防止重试或并发导致重复加分。联调时用同一请求连发三次，验证只入账一次。

三、积分接口返回要区分“业务失败”和“系统失败”。余额不足、已达上限属于业务失败，社区侧正常展示；超时、5xx属于系统失败，可重试并记录补偿任务。混在一起处理，排查会很痛苦。

四、联调前先约定字段语义。比如“帖子ID”是社区主键还是业务编号、“动作类型”枚举是否含“删帖扣分”，这些不写清楚，后期改字段比改逻辑还费劲。

总结一句：社区和积分是两个边界清晰的模块，对接的关键不是把接口调通，而是把失败场景想全。欢迎交流你们在模块联动中踩过的坑。