![[Bug]: StandardizeImage in deepdoc/vision/operators.py has a wrong name 'StandardizeImag'](https://www.chat-gpts.plus/wp-content/uploads/2026/07/7316-1ca7cb11.jpg)
[Bug]: StandardizeImage in deepdoc/vision/operators.py has a wrong name ‘StandardizeImag’
快速结论:该报错因为 deepdoc/vision/operators.py 中类名拼写错误导致,StandardizeImage 被误写为 StandardizeImag,使得预处理操作无法匹配到对应类。优先排查该文件中是否存在同类名拼写错误。
问题场景
用户使用 RAGFlow v0.17.1 版本(commit id: 4326873a),在调用图片预处理管线时,发现 StandardizeImage 操作无法生效,原因是对应的类定义名称拼写错误。排查时打开源码 deepdoc/vision/operators.py 即可发现问题。
报错原文
# 不是显式报错,而是操作未生效。根源是类名拼写错误:
# 类名定义为 StandardizeImag(缺少字母 e),
# 而外部引用或配置中查找的 key 是 'StandardizeImage',无法匹配。
原因分析
可能原因:deepdoc/vision/operators.py 中的类定义存在 typo,类名应为 StandardizeImage,但实际写成了 StandardizeImag。当预处理管线通过 key 来查找 'StandardizeImage' 操作时,找不到对应类,导致该预处理步骤被跳过。
环境排查
- RAGFlow 版本:v0.17.1(确认 commit id 为 4326873a)
- 影响文件:
deepdoc/vision/operators.py
解决步骤
- 打开
deepdoc/vision/operators.py源文件。 - 搜索
class StandardizeImag,将类名改为class StandardizeImage(补齐缺失的字母e)。 - (可选)检查该文件中是否有其他类似拼写错误,例如检查所有预处理器类名是否与外部配置/引用一致。
- 提交修复,或替换为官方已修复版本(参考 PR #16785)。
验证方法
重新运行图片预处理流程,确认 StandardizeImage 操作可以正常执行。也可直接查看操作日志,观察是否出现该预处理步骤的调用记录。



