Spring Boot集成Shiprocket API：密钥安全管理及‘Inventory sync is turned off’错误排查

1. API密钥管理 #

生成apiKey和apiSecret #

登录Shiprocket商家后台，进入「API集成」或「开发者工具」板块，创建新的API应用，提交后即可获取对应的apiKey和apiSecret。

安全存储与使用最佳实践 #

• 环境变量存储：将密钥存入服务器环境变量，Spring Boot通过@Value("${SHIPROCKET_API_KEY}")或Environment对象读取，完全避免硬编码在代码或配置文件中。
• 配置文件加密：使用jasypt-spring-boot-starter对配置文件中的密钥进行加密，示例：

  shiprocket.api.key=ENC(加密后的字符串)
  shiprocket.api.secret=ENC(加密后的字符串)
  

  启动时通过--jasypt.encryptor.password=解密密码指定解密密钥。
• 配置中心统一管理：借助Spring Cloud Config、Nacos等配置中心，将密钥加密后集中存储，避免配置文件分散带来的泄露风险。
• 代码规范：禁止在日志中打印密钥，不要将密钥硬编码到Java类中，仅在需要调用API的服务类中按需读取。

2. "Inventory sync is turned off"错误排查 #

• 检查控制台开关：登录Shiprocket后台，进入「库存管理」模块，确认「API库存同步」功能是否开启；同时检查API应用的权限设置，确保已分配「库存同步」和「订单创建」权限。
• 校验请求参数：创建订单或同步库存时，确认请求参数是否完整：
  • 是否指定了正确的仓库ID；
  • 是否包含库存同步相关标识（部分API需要显式传递sync_inventory=true参数）；
  • 商品SKU是否在Shiprocket后台已正确录入并关联库存。
• 权限验证：重新核对API密钥的权限列表，若缺少库存操作权限，需在后台为该API应用添加对应权限。
• 后台配置排查：若以上操作均无效，直接联系Shiprocket技术支持，排查账号侧的库存同步配置是否存在异常。

内容的提问来源于stack exchange，提问作者Surya R