【Bug已解决】`transformers.image_transforms.resize` doesnot work for negative values 解决方案

发布时间:2026/11/17 17:35:18

【Bug已解决】`transformers.image_transforms.resize` doesnot work for negative values 解决方案 【Bug已解决】transformers.image_transforms.resizedoesnot work for negative values 解决方案一、现象长什么样transformers.image_transforms.resize是图像预处理里把 PIL 图 resize 到目标尺寸的工具。当你传入负值作为目标尺寸时行为异常# 现象 A负值被当成绝对像素喂给 PIL直接报错 ValueError: width and height must be 0 # 传入 size(-1, 64) 或 size(64, -1)PIL.Image.resize 不接受负尺寸 # 现象 B负值的按比例语义没实现结果错 # 用户期望 size(256, -1) 表示宽 256、高按比例自动但代码直接把 -1 当尺寸 # resize 失败或产出错误形状 # 现象 C负坐标/负 crop 参数被静默接受图像被裁错 # resize 内部先 crop 再 resizecrop 框含负坐标PIL 行为未定义 - 图像错位 # 典型触发 from transformers.image_transforms import resize img resize(pil_image, size(-1, 224)) # 期望高 224、宽按比例实际报错最典型的指纹用户用负值表达某一维自动/按比例但resize没有这套语义把负值直接传给 PIL 导致报错或错误结果。二、背景图像 resize 在很多视觉 pipeline 里需要只固定一维、另一维按比例。常见约定如torchvision.transforms.Resizesize是单个 int → 短边缩放到该值长边按比例size是(h, w)元组且允许其中一个为-1表示该维自动按比例。但transformers.image_transforms.resize早期实现只支持两维都是正 int的简单情况没有处理一维为-1按比例负值应当报错或解释为相对/自动resize 前的 crop 步骤里出现的负坐标。于是负值要么被 PIL 拒绝现象 A要么被误当绝对尺寸现象 B要么在内部 crop 里产生未定义行为现象 C。三、根因根因有三类负值被直接传给 PIL.Image.resize。 PIL 的resize((w, h))要求w,h 0。image_transforms.resize没在调用 PIL 前把-1解析成按比例直接把(-1, 224)传进去 →ValueError: width and height must be 0。缺少一维 -1 自动的语义解析。 正确做法若size(256, -1)先算出当前图宽高比把-1替换成round(256 * 原高/原宽)。原实现没做这步 → 现象 B。内部 crop 的负坐标未裁剪/校验。 resize 流程有时先crop再 resize如先居中裁剪再缩。crop 框若含负坐标如(box[-10, 0, 100, 100])PIL 行为依赖于版本可能裁出错位图。应在 crop 前把负坐标 clamp 到[0, 边界]。四、最小可运行复现下面用纯 Python 模拟负值直接传给 PIL 报错而解析 -1 为按比例后正常from dataclasses import dataclass from typing import Tuple dataclass class FakePIL: w: int h: int def pil_resize(img: FakePIL, size: Tuple[int, int]): w, h size if w 0 or h 0: raise ValueError(width and height must be 0) return FakePIL(w, h) def resize_buggy(img: FakePIL, size: Tuple[int, int]): 有 bug直接把 size 传给 PIL。 return pil_resize(img, size) def resolve_neg(size: Tuple[int, int], img: FakePIL) - Tuple[int, int]: 修正把 -1 解析成按比例。 h, w size if h -1 and w ! -1: h round(img.h * w / img.w) elif w -1 and h ! -1: w round(img.w * h / img.h) return h, w def resize_fixed(img: FakePIL, size: Tuple[int, int]): h, w resolve_neg(size, img) return pil_resize(img, (h, w)) # 复现size(-1, 224) 直接传 PIL - 报错 img FakePIL(400, 300) try: resize_buggy(img, (-1, 224)) print(复现失败) except ValueError as e: print(复现成功(根因):, e) # 修正解析 -1 为按比例 out resize_fixed(img, (-1, 224)) print(按比例结果:, out.w, x, out.h) # 宽 224高应为 224 * 300/400 168 assert out.w 224 and out.h 168运行后buggy 版因-1直接传给 PIL 而ValueErrorfixed 版把-1解析成按比例224×300/400168复现并修复了根因 1/2。五、解决方案第一层最小直接修复最快的止血在调用PIL.Image.resize前先把-1解析成按比例的正尺寸并对 crop 负坐标做 clampfrom PIL import Image def safe_resize(image: Image.Image, size): 第一层修复支持 (256, -1) / (-1, 256) 按比例拒绝/修正负值。 # size 兼容 int 与 (h, w) 元组 if isinstance(size, int): size (size, size) h, w size oh, ow image.height, image.width # 解析 -1 - 按比例 if h -1 and w ! -1: h round(oh * w / ow) elif w -1 and h ! -1: w round(ow * h / oh) elif h -1 and w -1: raise ValueError(size 两维不能同时为 -1) # 防御其他负值直接报错非 -1 的负值无明确定义 if h 0 or w 0: raise ValueError(f解析后尺寸必须为正得到 ({h}, {w})) return image.resize((w, h)) # 使用 img Image.open(cat.jpg) resized safe_resize(img, (-1, 224)) # 宽 224高按比例第一层让用户立刻能用(256, -1)这类一维自动的写法负值不再崩。六、解决方案第二层结构性改进用ImageResizeNormalizer把负尺寸解析 crop 负坐标 clamp 异常类型统一收口from dataclasses import dataclass from typing import Tuple dataclass class ImageResizeNormalizer: 统一的图像 resize 参数归一化负号语义、crop 坐标校验。 def normalize_size(self, size, img_hw: Tuple[int, int]) - Tuple[int, int]: if isinstance(size, int): size (size, size) h, w size oh, ow img_hw if h -1 and w ! -1: h max(1, round(oh * w / ow)) elif w -1 and h ! -1: w max(1, round(ow * h / oh)) if h 0 or w 0: raise ValueError(fresize 目标尺寸必须为正得到 {(h, w)}) return h, w def clamp_crop_box(self, box, img_hw: Tuple[int, int]) - Tuple[int, int, int, int]: oh, ow img_hw left, top, right, bottom box # 负坐标 clamp 到 [0, 边界]避免 PIL 未定义行为 left max(0, left); top max(0, top) right min(ow, right); bottom min(oh, bottom) if right left or bottom top: raise ValueError(fcrop 框非法: {(left, top, right, bottom)}) return (left, top, right, bottom) # 使用 norm ImageResizeNormalizer() h, w norm.normalize_size((-1, 224), (300, 400)) box norm.clamp_crop_box((-10, 0, 100, 100), (300, 400))ImageResizeNormalizer把负尺寸语义 crop 负坐标收口resize 调用方不再各自处理避免遗漏。七、解决方案第三层断言 / CI 守护用 pytest 固化-1 按比例、非 -1 负值报错、crop 负坐标被 clampimport pytest def test_neg_one_means_proportional(): from img_resize_norm import ImageResizeNormalizer n ImageResizeNormalizer() h, w n.normalize_size((-1, 224), (300, 400)) assert w 224 and h 168 def test_both_neg_raises(): from img_resize_norm import ImageResizeNormalizer n ImageResizeNormalizer() with pytest.raises(ValueError): n.normalize_size((-1, -1), (300, 400)) def test_non_neg_one_negative_raises(): from img_resize_norm import ImageResizeNormalizer n ImageResizeNormalizer() with pytest.raises(ValueError): n.normalize_size((-5, 224), (300, 400)) # -5 不是 -1无定义 def test_crop_negative_clamped(): from img_resize_norm import ImageResizeNormalizer n ImageResizeNormalizer() box n.clamp_crop_box((-10, 0, 100, 100), (300, 400)) assert box[0] 0, 负 crop 坐标应被 clamp 到 0CI 跑pytest tests/test_image_resize.py以后只要有人又把负值裸传给 PIL或忘了按比例解析测试立刻红灯。八、排查清单当image_transforms.resize遇负值异常按顺序查width and height must be 0→ 负值被直接传给 PIL用safe_resize先解析-1为按比例。想只固定一维 → 用(256, -1)/(-1, 256)确保有解析逻辑。非-1的负值如-5→ 无明确定义应当报错而非静默。crop 后 resize 图像错位 → crop 框含负坐标用clamp_crop_box钳到[0, 边界]。长期方案用ImageResizeNormalizer统一负尺寸语义 crop 校验。九、小结transformers.image_transforms.resizedoesnot work for negative values 的根因是resize 没有实现一维-1表示按比例的语义把负值直接传给PIL.Image.resize要求 0导致报错同时内部 crop 的负坐标未被校验/clamp产生未定义行为。第一层调用 PIL 前把-1解析成按比例正尺寸并对 crop 负坐标 clamp立刻可用(256, -1)。第二层用ImageResizeNormalizer统一负尺寸语义 crop 坐标校验避免遗漏。第三层pytest 断言-1 按比例、非 -1 负值报错、crop 负坐标 clamp防止回归。记住图像 resize 的负值应只用于一维自动-1 按比例这一约定且必须在调用 PIL 前解析成正数其它负值无定义应明确报错而非静默传给底层库。
延伸阅读

更多相关文章

2026/11/17 17:35:18

【Bug已解决】Checkpoint validation as an option 解决方案

【Bug已解决】Checkpoint validation as an option 解决方案 一、现象长什么样 你希望 save_pretrained / from_pretrained 提供可选的 checkpoint 校验(验证完整性、可加载性),但实际行为二选一,很难受: # 现象 A&…

2026/11/17 17:35:17

解决90%的常见问题:Blender VS Code故障排除与日志分析指南

解决90%的常见问题:Blender VS Code故障排除与日志分析指南 【免费下载链接】blender_vscode Visual Studio Code extension for Blender development. 项目地址: https://gitcode.com/gh_mirrors/bl/blender_vscode Blender VS Code扩展是一款专为Blender开…

2026/11/16 14:21:51

Spoke:无需3D建模经验!快速创建自定义3D环境的终极指南

Spoke:无需3D建模经验!快速创建自定义3D环境的终极指南 【免费下载链接】Spoke Easily create custom 3D environments 项目地址: https://gitcode.com/gh_mirrors/spo/Spoke Spoke 是一款强大的开源工具,专为快速创建自定义3D环境而设…

2026/11/17 17:33:08

40岁电工证怎么考才不白花钱 电子证书到底值不值

40岁电工证怎么考才不白花钱 电子证书到底值不值 怕考不过白交培训费,这事儿我懂。我朋友老王,40多岁从工厂转岗,想干电工,结果被培训机构套路了,交了5000块培训费,考试挂了,说补考还得再交钱。我问他为啥不早问清楚?他摇摇头说:“这年头,…

2026/11/17 17:33:08

电工证自学备考到期换证流程,良心建议别走弯路

电工证自学备考到期换证流程,良心建议别走弯路 之前考的证在外省能不能转过来?这可能是很多电工从业者心头最大的一块石头。尤其对于在郑州金水区从事劳务班组的负责人来说,证书的合规性与可迁移性直接关系到团队作业的资质和安全性。今天就从一个老电工的…

2026/11/17 17:33:08

三明市低压电工证培训怎么考?含金量高不高?看完这篇就够了

三明市低压电工证培训怎么考?含金量高不高?看完这篇就够了 你是不是正在找工作,但因为没有低压电工证被拒?或者你已经有一份工作,但想要晋升,却发现没有这个证就卡住了?别急,三明市低压电工证培训就是你的突破口。这个证的 含金量…

2026/11/17 17:33:08

考电工证需要任职证明保姆级教程:外省证书能转吗?全流程详解

考电工证需要任职证明保姆级教程:外省证书能转吗?全流程详解 之前考的证在外省能不能转过来?这是很多电工朋友的共同疑问,特别是那些已经持有证书但因工作变动、搬家或想在新城市发展的电工,更关心证书是否能跨省使用。其实,电工证属于全国通用证书,…

2026/11/17 17:33:08

福清电工证培训机构在哪考?证书过期了不知道怎么复审延期

福清电工证培训机构在哪考?证书过期了不知道怎么复审延期 你是不是也遇到过这种情况:手里拿着电工证,结果一不小心就过期了,想着去复审,结果发现不知道在哪考,流程也一头雾水?其实这不光是你一个人的问题,很多特种作业人员在证书管理上都容易踩坑。尤…

2026/11/17 17:28:07

武汉建筑特种工培训通过率揭秘:怎么避开中介陷阱

武汉建筑特种工培训通过率揭秘:怎么避开中介陷阱 不知道去哪报名怕被中介坑?现在武汉建筑特种工培训项目越来越多,但真假难辨,很多学员在选择培训机构时都遇到过类似问题。武汉本地的培训机构鱼龙混杂,有些打着“包过”“包证”的旗号,实则资质不全、课…

2026/11/17 17:09:16

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑