SuiteCRM用户偏好重置问题分析与解决方案

问题现象

在SuiteCRM 7.14.6版本中，本地用户每次登录系统时都会强制显示"欢迎向导"界面。这一问题主要影响通过本地认证方式创建的用户，而通过LDAP认证的用户则不受影响。该问题源于系统对用户偏好设置的异常处理机制。

问题根源

经过技术分析，该问题的根本原因在于reloadPreferences()函数中的条件判断逻辑存在缺陷。具体表现为：

1. 当用户首次登录或密码输入错误时，系统会重置用户偏好设置
2. 偏好设置重置后触发欢迎向导的强制显示
3. 函数中的条件判断if (!$GLOBALS['current_user']->id || $GLOBALS['current_user']->user_name === $user->user_name)在特定场景下无法正确执行

技术细节

问题主要出现在modules/UserPreferences/UserPreference.php文件中的reloadPreferences()函数实现。该函数负责加载和刷新用户偏好设置，但在以下场景中存在缺陷：

1. Cron任务执行时：当通过命令行执行定时任务时，由于current_user始终为管理员账户，导致目标用户的会话数据无法正确加载
2. 密码错误场景：用户输入错误密码后，偏好设置会被意外重置
3. 会话管理：偏好设置未能正确保存到用户对应的会话存储中

解决方案

方案一：移除条件判断

最直接的解决方案是完全移除有问题的条件判断，让所有情况下的用户偏好都能正确加载：

// 修改前
if (!$GLOBALS['current_user']->id || $GLOBALS['current_user']->user_name === $user->user_name){
    $_SESSION[$user->user_name . '_PREFERENCES'][$category] = unserialize(base64_decode($row['contents']));
}

// 修改后
$_SESSION[$user->user_name . '_PREFERENCES'][$category] = unserialize(base64_decode($row['contents']));

方案二：增强条件判断

更精细化的解决方案是扩展条件判断，增加对命令行环境的特殊处理：

if (PHP_SAPI === 'cli' || $GLOBALS['current_user']->user_name === $user->user_name){
    $_SESSION[$user->user_name . '_PREFERENCES'][$category] = unserialize(base64_decode($row['contents']));
}

这种方案通过检测PHP运行环境(PHP_SAPI)来确保在命令行模式下也能正确加载用户偏好。

额外优化建议

对于使用Google日历同步功能的用户，建议同时对include/GoogleSync/GoogleSyncBase.php文件中的getGoogleClient函数进行优化：

// 修改前
$this->workingUser->setPreference('GoogleApiToken', base64_encode(json_encode($client->getAccessToken())), 'GoogleSync');

// 修改后
$this->workingUser->setPreference('GoogleApiToken', base64_encode(json_encode($client->getAccessToken())), 0, 'GoogleSync');

这一修改确保Google API令牌被正确保存在"GoogleSync"分类下，避免每次运行都强制刷新令牌。

实施建议

1. 对于生产环境，建议采用方案二进行修复，它提供了更精确的控制
2. 修复后应清除所有用户会话数据，确保新设置能够正确加载
3. 对于使用Google日历同步的系统，建议同时实施额外优化建议
4. 更新后应进行全面的功能测试，特别是多用户登录和定时任务场景

该问题的修复将显著提升用户体验，避免不必要的向导干扰，同时保证系统功能的完整性和稳定性。