自定义Dolibarr密码90天过期功能致PrestaShop订单同步异常

核心背景 #

为Dolibarr开发了90天密码强制过期的自定义功能后，功能本身正常运行，但原本正常的PrestaShop→Dolibarr订单同步功能失效。经回滚测试确认，仅修改/core/lib/security2.lib.php和/core/login/functions_dolibarr.php两个文件会触发该同步异常。

可能原因与排查步骤 #

• 同步账号的认证拦截
  检查两个文件中修改的认证逻辑：

  • security2.lib.php里是否新增了密码过期校验函数（如checkPasswordExpiry），且未对同步专用的系统账号做豁免处理，导致同步请求因密码过期被拒绝
  • functions_dolibarr.php中是否修改了登录流程，新增了强制修改密码的跳转/拦截逻辑，阻断了同步脚本的自动登录

• 会话/令牌机制变更
  若修改了security2.lib.php中的会话生成、验证或销毁规则，可能导致同步插件依赖的Dolibarr API令牌或会话失效，进而无法完成订单数据推送。

• 错误日志定位

  • 开启Dolibarr调试模式（修改/conf/conf.php中$dolibarr_main_prod = 0），查看同步请求触发的具体错误栈信息
  • 检查PrestaShop同步插件的日志，确认是否收到Dolibarr返回的401 Unauthorized、权限不足等明确报错

• 函数调用冲突
  排查同步模块是否调用了被修改的函数：比如同步流程可能调用functions_dolibarr.php中的登录验证函数，若新增的密码过期逻辑未排除同步账号，就会触发拦截。

临时修复方向 #

• 给同步专用账号添加豁免逻辑：在密码过期校验代码中，通过用户ID、登录名等标识判断是否为同步账号，跳过过期检查
• 逐步回滚两个文件中的修改代码，定位到具体引发冲突的代码段，针对性调整而非完全回滚功能

内容的提问来源于stack exchange，提问作者José Manuel Ruiz Ruiz