相信很多使用百度 UEditor 编辑器的小伙伴，都遇到过这样的问题：本地测试上传图片一切正常，部署到服务器后，图片就无法显示了。检查源码发现，img 标签的 src 属性里多了反斜杠，变成了 `\/pic/xxx.jpg`，而非正常的 `/pic/xxx.jpg`。今天就把完整的排查过程和解决方法分享给大家，亲测有效！

一、问题现象

上传图片后，编辑器内图片无法预览，浏览器控制台提示报错：`GET http://pic/images/20260716/xxx.jpg net::ERR_NAME_NOT_RESOLVED`，简单来说，就是浏览器把路径里的 `pic` 当成了域名去解析，自然找不到图片。

查看编辑器生成的 HTML 源码，异常路径如下：

<img src="\/pic/images/20260716/1784214742436717.jpg" />

正常路径应该是这样的：

<img src="/pic/images/20260716/1784214742436717.jpg" />

这个问题不仅会导致上传后无法预览，还会让用户无法确认上传状态，即便盲保存，前端页面展示时图片也会失效，影响使用体验。

二、环境信息

先说明下我的项目环境，方便大家对照排查，不同环境排查方向略有差异：

三、完整排查过程（按优先级排序，建议照着做）

排查问题最忌讳盲目修改，建议按照以下步骤逐步定位，每一步都能排除一个可能性，最终找到根源。

第一阶段：确认问题边界，缩小范围

1. 本地环境测试（正常）

本地开发环境是 Windows + Apache，上传图片后，编辑器能正常显示，源码路径也无异常，说明代码本身逻辑没有问题，问题出在服务器环境差异上。

2. 服务器环境测试（异常）

部署到 IIS 服务器后，立即出现 `\/` 转义问题，初步怀疑是 PHP 的 `json_encode` 函数默认行为导致（该函数默认会将 `/` 转义为 `\/`）。

3. 排除 json_encode 默认转义

按照常规思路，在所有 `json_encode` 调用处添加 `JSON_UNESCAPED_SLASHES` 参数（禁用斜杠转义），但修改后问题依旧，说明根源不在这一步。

第二阶段：逐个环节排查，定位异常点

4. 检查 PHP 字符串替换是否生效

为了验证字符串替换功能，我创建了一个简单的诊断脚本，放在服务器上运行：

<?php

$test = ["url" => "/pic/images/test.jpg"];

echo "json_encode: " . json_encode($test) . "\n";

echo "str_replace: " . str_replace('\/', '/', json_encode($test)) . "\n";

?>

运行结果显示，`str_replace` 能正常将 `\/` 替换为 `/`，说明字符串替换功能在服务器上是正常的。

5. 检查服务器返回的原始 JSON

这一步很关键！打开浏览器 F12，切换到 Network 标签，找到上传图片的请求（`controller.php?action=uploadimage`），查看 Response 原始内容：

{"state":"SUCCESS","url":"/pic/images/20260716/1784214742436717.jpg","title":"...","original":"...","type":".jpg","size":11082}

可以看到，服务器返回的 JSON 中，`url` 字段已经是正确的 `/pic/...` 格式，说明后端代码返回的数据是正常的，问题不在后端。

第三阶段：定位到浏览器端，排查 UEditor 处理逻辑

6. 检查 UEditor 处理后的内容

既然后端返回正常，那问题大概率出在前端 UEditor 的 JS 处理环节。在浏览器控制台执行以下代码，查看编辑器处理后的内容：

UE.instants['ueditorInstant0'].getContent()

返回结果显示，内容中出现了 `\\/`，这就说明，服务器返回的正常路径，经过 UEditor JS 处理后，被再次转义了。

7. 尝试关闭 UEditor 内置过滤规则

首先想到的是 UEditor 的 XSS 过滤功能可能影响路径，修改 `ueditor.config.js`，关闭相关过滤：

,outputXssFilter: false

,xssFilterRules: false

但修改后重启编辑器，问题依旧，说明不是过滤规则的问题。

第四阶段：最终定位——PHP magic_quotes_gpc 配置

8. 关键线索：废弃功能的兼容问题

虽然 PHP 7.4 已经废弃了 `magic_quotes_gpc` 功能，但在 Windows IIS + PHP 的环境中，部分兼容层或 PHP 管理器可能仍保留了类似行为，这是很多人容易忽略的点。

9. 验证并解决：添加 stripslashes 去转义

在 `action_upload.php` 文件中，对返回的图片路径添加去转义处理，代码如下：

// 兼容旧版 PHP magic_quotes 转义问题

if (function_exists('get_magic_quotes_gpc') && @get_magic_quotes_gpc()) {

   $url = stripslashes($url);

}

添加后重新上传图片，问题解决！编辑器能正常显示图片，源码路径也恢复正常。

以上解决办法是百度搜索后，百度AI给的回答，百度编辑器就是百度开发的，只有他们自己对这个问题一下就说出原因了

四、原理分析

很多小伙伴可能好奇，为什么会出现这个问题？这里简单解释一下，方便大家理解。

1. 什么是 magic_quotes_gpc？

这是 PHP 早期版本的一个自动转义机制，当该配置为 `On` 时，PHP 会自动对 `$_GET`、`$_POST`、`$_COOKIE` 中的特殊字符（单引号、双引号、反斜杠、NULL 字符）添加反斜杠进行转义，目的是提升安全性，但后期因实用性不足被废弃。

2. 为什么会导致 `\/` 转义？

UEditor 上传逻辑中，前端 JS 会请求后端获取上传结果。虽然我们在代码中手动拼接了正确的 JSON 字符串，但在 IIS + PHP 环境下，`magic_quotes_gpc` 的兼容层被触发，导致返回的路径中的 `/` 被转义为 `\/`，最终经过 UEditor JS 处理后，变成了无法识别的路径。

3. 为什么本地没问题？

本地开发环境使用的是 Apache，默认关闭了 `magic_quotes_gpc`，不会触发自动转义；而服务器是 IIS + PHP，开启了该配置的兼容层，因此出现了环境差异导致的异常。

五、解决方案（三种方案，按需选择）

结合排查结果，整理了三种解决方案，从根源解决到代码兜底，大家可以根据自己的操作权限选择。

方案一（推荐）：彻底关闭 magic_quotes_gpc

这是最根本的解决方法，找到服务器的 `php.ini` 配置文件（常见路径如下），打开后搜索并修改配置：

常见 php.ini 路径：

1. C:\PHP\php.ini

2. C:\Program Files\PHP\v7.4\php.ini

3. C:\Windows\php.ini

修改配置项：

magic_quotes_gpc = Off

修改完成后，重启 IIS 服务器，即可彻底解决问题。

方案二（代码防御）：stripslashes 兜底处理

如果没有服务器配置修改权限，可以在代码中添加去转义处理，作为兜底方案。在接收和处理上传返回路径的文件中（如 `action_upload.php`），添加以下代码：

// 兼容旧版 PHP magic_quotes 转义问题

if (function_exists('get_magic_quotes_gpc') && @get_magic_quotes_gpc()) {

   $url = stripslashes($url);

}

方案三（多重保险）：保存和输出时双重清理

为了避免后续出现类似问题，建议在数据保存和前台输出两个环节，都添加路径清理逻辑，双重保障：

1. 保存到数据库前：对全局 POST 数据进行处理，使用 `array_walk_recursive` 结合 `str_replace('\/', '/', ...)` 清理转义字符；

2. 前台展示时：对输出的富文本内容，再执行一次 `str_replace('\/', '/', ...)`，确保路径正常。

六、总结与建议

通过这次排查，给大家总结几个关键点，避免踩坑：

1. 不要盲目依赖前端配置：UEditor 的 `outputXssFilter` 和 `xssFilterRules` 不是该问题的根本原因，关闭后无法解决问题，反而可能降低安全性；

2. 重视环境差异：Windows + IIS + PHP 环境，要重点检查 `magic_quotes_gpc` 等废弃配置的兼容问题，这是此类异常的高发诱因；

3. 做好多层防御：即便解决了根本问题，建议在保存和输出环节保留清理逻辑，作为兜底，避免后续环境变动再次出现问题；

4. 快速验证方法：上传图片后，通过 F12 查看后端返回的 JSON 是否正常、编辑器处理后的内容是否有转义、数据库存储的内容是否异常，三步就能定位问题。

七、最终文件改动清单（方便对照修改）

整理了本次修复涉及的所有文件，大家可以对照自己的项目路径，逐一修改：

以上就是本次 UEditor 图片路径转义问题的完整排查和解决过程