TYPO3 10.4.21版本fileadmin中的图片及视频无法在页面显示如何解决

1 文件存储与权限校验 #

• 首先确认上传目录拼写：默认TYPO3公共上传目录为fileadmin/user_upload，若你手动创建的是user_uplaod目录，需先确认目录名称与代码调用路径一致
• 目录与文件权限配置：Linux环境下fileadmin及子目录权限建议设为755，文件权限设为644，确保Web服务运行用户拥有可读权限
• 确认站点配置中开放了fileadmin目录的公共访问权限：进入后台站点管理 > 对应站点 > 设置，检查资源路径配置未限制fileadmin目录访问

2 文件索引与权限配置 #

• 进入后台文件列表模块，打开对应媒体文件的编辑页，确认访问权限设置为公开，未配置用户组访问限制
• 重建文件索引：进入后台系统 > 清理，执行重建文件索引任务，刷新文件元数据记录
• 校验默认文件存储配置：进入站点管理 > 维护 > 文件存储，确认默认存储的公共选项已开启，基础路径指向fileadmin/

3 内容元素与模板渲染校验 #

• 确认pizpalue主题媒体渲染配置开启：进入模板 > 常量编辑器，筛选pizpalue扩展配置，确认启用媒体元素渲染、允许MP4格式视频选项已开启
• 检查Fluid Styled Content模板是否被异常覆盖：若你使用Sitepackage Builder自定义了站点包，确认未覆盖Media内容元素的默认渲染模板，自定义模板需包含<f:media>官方标签调用逻辑，可参考核心扩展fluid_styled_content的默认Media模板写法
• 执行全量缓存清理：点击后台顶部闪电图标，选择清除所有缓存，同时清除浏览器缓存后再测试

4 系统与服务端配置校验 #

• 检查LocalConfiguration.php配置：确认fileDenyPattern规则未屏蔽MP4等媒体格式，[FE][file_extensions]配置中包含你使用的mp4、jpg、png等媒体后缀
• 确认Web服务器MIME类型配置正确：Nginx/Apache需配置video/mp4对应MP4后缀，避免服务器将视频识别为二进制文件禁止访问

5 前端请求排查 #

• 打开前端页面开发者工具的网络标签，刷新页面查看媒体文件的请求状态：
  • 状态码403：回到第一步重新检查目录权限、文件访问限制配置
  • 状态码404：检查文件实际路径与请求路径是否一致，确认静态路由规则未屏蔽fileadmin目录访问
  • 状态码200但无法播放：检查源文件是否损坏，或服务端MIME类型配置错误

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