Typo3 v8中"Text & Media"模块图片宽高为0px且未在HTML生效的解决咨询

我之前维护TYPO3 v8项目时也碰到过完全一样的问题，折腾了好几个小时才排查出不同诱因，给你整理几个最靠谱的解决方向：

1. 检查Fluid模板的图片渲染逻辑 #

这是最常见的原因——你的内容元素模板可能没正确读取并输出后台设置的图片宽高属性。

如果用f:image ViewHelper，要确保传递了后台设置的宽高值：

<f:image 
    image="{image}" 
    width="{image.properties.width}" 
    height="{image.properties.height}"
    alt="{image.properties.alternative}"
/>

如果是直接输出img标签，也要手动绑定宽高字段：

<img 
    src="{f:uri.image(image: image)}" 
    width="{image.properties.width}" 
    height="{image.properties.height}"
    alt="{image.properties.alternative}"
/>

注意：如果模板里用了crop参数或强制缩放规则，会覆盖后台设置的宽高，可先暂时移除这类配置测试。

2. 验证TYPO3图片处理配置 #

检查typo3conf/LocalConfiguration.php里的图片处理相关配置，确保没有强制重置宽高：

$GLOBALS['TYPO3_CONF_VARS']['GFX'] = [
    'image_proc' => 'GD', // 确保启用了正确的图片处理库（GD/ImageMagick）
    'maxImageWidth' => 0, // 0表示不限制最大宽度，不要设固定值导致覆盖
    'maxImageHeight' => 0,
    'disableImageMagick' => false,
];

如果配置了ImageMagick，还要确保服务器已安装对应工具且路径配置正确。

3. 排查CSS样式覆盖 #

打开浏览器开发者工具，检查图片元素的计算样式，看是否被全局CSS强制设为width: 0或height: 0。比如有些主题会写：

img {
    width: 0 !important;
    height: auto !important;
}

这种情况需要修改对应CSS规则，或者给Text & Media的图片添加专属类名，针对性设置宽高。

4. 升级到TYPO3 v8的最新补丁版本 #

TYPO3 v8的部分早期小版本存在图片渲染bug，比如后台设置的宽高未正确传递到前端。建议升级到v8系列最后一个维护版本（v8.7.49），很多已知问题都在补丁里修复了。

5. 检查图片裁剪设置 #

如果你在Text & Media里给图片设置了裁剪，要确保裁剪区域已正确保存。有时候裁剪操作未生效会导致TYPO3无法计算正确宽高值，此时可尝试移除裁剪，重新设置图片宽高再测试。

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