什么是非版本化文件？Debian服务器REDCap报错求助

什么是非版本化文件 #

REDCap的核心代码通常存放在以版本号命名的目录中（比如redcap_v12.3.0），而服务器主REDCap目录下不在这个版本目录里的文件就是非版本化文件。这类文件包括：

• 核心配置文件config.php（自定义配置，不会随版本包更新）
• 根目录的入口文件（如index.php、install.php）
• 自定义插件或第三方集成文件
• REDCap升级过程中遗留的辅助脚本或资源文件

这些文件是REDCap运行必需的，但不属于核心版本包的一部分，REDCap会定期校验它们的完整性和版本匹配度。

报错及空ZIP的原因与解决方法 #

可能的原因 #

1. PHP 8.1的兼容性变化触发了REDCap文件校验脚本的误判——比如PHP 8.1对文件读取、哈希计算的逻辑调整，导致脚本认为文件“过时”。
2. 文件权限不足：web服务器用户（如www-data）无法读取主目录下的部分文件，导致校验脚本无法正确对比文件哈希，生成ZIP时也无法获取文件内容。
3. REDCap缓存过期：旧的缓存数据干扰了校验逻辑，导致错误判断。

解决步骤 #

1. 手动核对文件一致性
   找到你当前使用的REDCap官方版本包，解压后对比服务器主目录下的文件（排除config.php等你自定义的文件），看是否有文件和官方包不一致的情况。如果有，直接用官方包的文件替换（注意备份自定义文件）。

2. 修复文件权限
   执行以下命令确保web服务器用户拥有REDCap目录的读写权限：

   chown -R www-data:www-data /path/to/your/redcap
   chmod -R 755 /path/to/your/redcap
   

   替换/path/to/your/redcap为你的REDCap实际路径。

3. 清除REDCap缓存

   • 登录REDCap后台，找到“系统管理”→“清除系统缓存”选项执行清除。
   • 或者手动删除临时缓存目录：

     rm -rf /path/to/your/redcap/temp/*
     

4. 重新触发文件校验
   回到报错页面，或者在后台找到“版本检查”/“系统状态”模块，重新运行文件完整性校验，看报错是否消失。

5. 手动替换核心非版本化文件
   如果还是无法生成有效ZIP，直接从官方REDCap版本包中提取主目录下的核心文件（如index.php、license.php、robots.txt等），备份服务器上的对应文件后替换。注意不要覆盖config.php和自定义插件。

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