Snipe-IT升级后版本号未更新的解决方案

问题描述

在使用Snipe-IT资产管理系统的过程中，用户从v7.0.9升级到最新版本时遇到了一个常见问题：尽管升级过程顺利完成且没有报错，但系统底部显示的版本号仍然停留在v7.0.13，而不是预期的当前最新版本号。

问题分析

通过查看详细的升级日志，我们可以发现关键错误信息：

Problem 1
- lcobucci/jwt is locked to version 5.3.0 and an update of this package was not requested.
- lcobucci/jwt 5.3.0 requires ext-sodium * -> it is missing from your system. Install or enable PHP's sodium extension.

这表明系统缺少PHP的sodium扩展，导致依赖包lcobucci/jwt无法正常更新，进而影响了整个系统的完整升级。

解决方案

1. 安装PHP sodium扩展

根据系统环境不同，安装方式有所差异：

对于基于RPM的系统（如Fedora/CentOS/RHEL）：

sudo dnf install php-sodium

对于基于Debian的系统（如Ubuntu/Debian）：

sudo apt-get install php-sodium

安装完成后，需要重启PHP服务：

sudo systemctl restart php-fpm

2. 验证扩展安装

通过以下命令检查sodium扩展是否已正确安装并启用：

php -m | grep sodium

3. 重新执行升级流程

扩展安装完成后，建议重新执行完整的升级流程：

php upgrade.php

技术背景

Sodium扩展是PHP的一个加密库，提供了现代加密算法实现。在Snipe-IT中，它被用于JWT(JSON Web Tokens)的生成和验证，这是OAuth 2.0认证流程的重要组成部分。当这个扩展缺失时，虽然系统可能看起来正常运行，但某些关键功能（如版本信息更新）可能会受到影响。

预防措施

为避免类似问题，建议在升级前：

1. 检查系统是否满足所有PHP扩展要求
2. 备份数据库和代码
3. 在测试环境先行验证升级流程
4. 查看官方文档了解最新版本的系统要求

总结

Snipe-IT版本号未更新的问题通常是由于PHP环境不完整导致的。通过安装缺失的sodium扩展并重新执行升级流程，可以解决这一问题。这提醒我们在进行系统升级时，不仅要关注应用程序本身的更新，还要确保运行环境满足所有依赖要求。