图像不上传或消失.

让上传正常工作并将上传文件保留在网站上。图像通过页面构建器自带上传到达页面，网站使用媒体库时则通过媒体库。大多数失败是媒体设置、文件权限或上传未到达服务器所致。

媒体浏览器缺失或打开为空

1. 前往 DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings），然后打开 Media 版块。
2. 设置 Browser type 为 Media Library 并点击 Save settings。该选项仅在核心 Media Library 模块启用时出现。选择 Media Library (Acquia DAM) 如果您使用 Acquia DAM。
3. 前往 Structure > Media types 并检查机器名为以下内容的媒体类型 image 存在（video 视频）。页面构建器在该类型上打开媒体库。

注意： Basic file upload 显示普通 Select image 直接从您的计算机上传的按钮。当 Media Library 未启用时默认使用它。Entity Browser 是旧选项；请优先使用 Media Library。

上传失败并出错

• "Destination file path is not writable" or "File could not be saved". Web 服务器无法写入文件目录。请 sites/default/files 对 Web 服务器用户可写，然后检查 Reports > Status report.
• "Only files with the following extensions are allowed". 页面构建器接受 GIF、JPEG、PNG、WebP、AVIF 和 SVG 图像，以及 WebM、Ogg 和 MP4 视频。在 Media Library 中，媒体类型决定：在以下位置添加扩展名 允许的文件扩展名 图像字段的，位于 Structure > Media types > Image > Manage fields.
• "exceeding the maximum file size", or "The uploaded video is too large". 文件大于 PHP 接受的大小。提高 upload_max_filesize 和 post_max_size PHP 方面，以及 Web 服务器或代理的正文大小限制。
• 403 或 405，位于 /dxpr_builder/ajax/file_upload. 代理或防火墙阻止或重定向到该路径的 POST 请求。请将其加入允许名单，并确保网站不重定向它，例如从 HTTP 重定向到 HTTPS。
• 编辑人员在媒体浏览器中看到 "Access denied"。 该角色需要 View media 以打开 Media Library，并 Image: Create new media 以在其中上传。在以下位置授予两者 People > Permissions.

上传几小时后图像消失

文件从以下位置消失 sites/default/files/dxpr_builder_images 且页面显示破损图像。

3.0.0-alpha85 之前的版本在 Media 模块关闭时将页面构建器上传保存为临时文件。Drupal 的 cron 六小时后删除临时文件。

1. 更新到当前版本。它将上传保存为永久文件并记录其使用。
2. 重新上传缺失的图像，或从备份恢复到同一文件夹。

注意： 上传到 dxpr_builder_images, dxpr_builder_videos 和 dxpr_builder_files 默认文件目录中。

图像在编辑器中显示但访客看不到

• 重新加载后图像消失。 容器未保存。重新添加图像并点击 Save 在容器栏上。
• 您看到图像，访客看不到。 Apply text format filters to frontend content 在以下位置打开 General Settings > Text Filters，字段的文本格式移除 img 标签或其属性。编辑人员始终看到未过滤的内容。关闭设置，或允许 img 该文本格式中。
• 访客看到旧版页面。 缓存提供的是旧页面。参见 访客看到不同内容。

确认修复

上传图像到 Image 元素并保存容器。在隐私窗口中图像对匿名访客显示。

接下来做什么？

Media Library integration 在页面构建器中复用现有媒体。