Snipe-IT项目表格显示异常的解决方案

问题现象

最近有用户报告在升级Snipe-IT资产管理系统后，仪表盘上的"位置"和"资产"分类不再显示。具体表现为：

1. 在任何位置页面中，设备列表无法显示
2. 虽然计数器显示有设备存在，但列表为空
3. 打印预览功能却能正常显示该位置的所有设备

问题原因

经过分析，这是由于浏览器存储机制导致的显示问题。Snipe-IT系统使用了一个名为BS_TABLE_STORAGE的环境变量来控制表格数据的存储方式，它有两种可选值：

• cookieStorage：使用浏览器cookie存储表格排序、分页等偏好设置
• localStorage：使用浏览器的本地存储功能

当用户自定义字段较多或数据量较大时，cookie可能会超出大小限制，导致表格无法正常渲染。

解决方案

要解决此问题，请按照以下步骤操作：

1. 清除浏览器缓存和cookie
   首先清除浏览器中与Snipe-IT相关的所有cookie和缓存数据。

2. 修改环境配置
   打开项目的.env文件，找到以下配置项：

   BS_TABLE_STORAGE=cookieStorage
   

   将其修改为：

   BS_TABLE_STORAGE=localStorage
   

3. 清除配置缓存
   如果你使用了配置缓存，需要运行以下命令清除：

   php artisan config:clear
   

技术背景

localStorage相比cookie有以下优势：

• 存储容量更大（通常5MB vs cookie的4KB）
• 不会随每个HTTP请求发送到服务器
• 提供更简单的API进行操作
• 数据永久保存，除非主动删除

在Snipe-IT这样的资产管理系统中，用户可能会有大量自定义字段和复杂的数据展示需求，使用localStorage能更好地支持这些功能，避免因数据量过大导致的显示问题。

最佳实践

建议所有Snipe-IT用户都将此配置项设置为localStorage，特别是：

• 系统中有大量自定义字段的情况
• 用户数量较多的环境
• 需要复杂表格展示和排序的场景

这样可以确保系统在各种使用场景下都能稳定运行，避免类似显示问题的发生。