# [一套适合 SAP UI5 初学者循序渐进的学习教程](https://blog.csdn.net/i042416/category_11395500.html)

## 作者简介

Jerry Wang，2007 年从电子科技大学计算机专业硕士毕业后加入 SAP 成都研究院工作至今。Jerry 是 SAP 社区导师，SAP 中国技术大使。在长达 15 年的 SAP 标准产品开发生涯里，Jerry 曾经先后参与 SAP Business ByDesign, SAP CRM, SAP Cloud for Customer, SAP S/4HANA, SAP Commerce Cloud(电商云)等标准产品的研发工作。

Jerry 工作中使用 ABAP, Java, JavaScript 和 TypeScript 进行开发, 对包括 SAP UI5 在内的多款 SAP 自研框架有深入的研究。

## 教程目录

* [SAP UI5 本地开发环境的搭建](https://jerry.blog.csdn.net/article/details/120611706)

* [SAP UI5 应用开发教程之一：Hello World](https://jerry.blog.csdn.net/article/details/120612455)

* [SAP UI5 应用开发教程之二：SAP UI5 的引导过程 Bootstrap](https://jerry.blog.csdn.net/article/details/120614665)

* [SAP UI5 应用开发教程之三：开始接触第一个 SAP UI5 控件](https://jerry.blog.csdn.net/article/details/120619615)

* [SAP UI5 应用开发教程之四：XML 视图初探](https://jerry.blog.csdn.net/article/details/120642096)

* [SAP UI5 应用开发教程之五：视图控制器初探](https://jerry.blog.csdn.net/article/details/120669241)

* [SAP UI5 应用开发教程之六 - 了解 SAP UI5 的模块(Module)概念](https://jerry.blog.csdn.net/article/details/120680451)

* [SAP UI5 应用开发教程之七 - JSON 模型初探](https://jerry.blog.csdn.net/article/details/120693394)

* [SAP UI5 应用开发教程之八 - 多语言的支持](https://jerry.blog.csdn.net/article/details/121039416)

* [SAP UI5 应用开发教程之九 - 创建第一个 Component](https://jerry.blog.csdn.net/article/details/121042479)

* [SAP UI5 应用开发教程之十 - 什么是 SAP UI5 应用的描述符 Descriptor](https://jerry.blog.csdn.net/article/details/121049973)

* [SAP UI5 应用开发教程之十一 ：SAP UI5 容器类控件 Page 和 Panel](https://jerry.blog.csdn.net/article/details/121060759)

* [SAP UI5 应用开发教程之十二 - 使用 CSS 类对 UI 进行进一步美化](https://jerry.blog.csdn.net/article/details/121063066)

* [SAP UI5 应用开发教程之十三 - 如何添加自定义 CSS 类](https://jerry.blog.csdn.net/article/details/121180115)

* [SAP UI5 应用开发教程之十四 - 嵌入视图的使用方式](https://jerry.blog.csdn.net/article/details/122420230)

* [SAP UI5 应用开发教程之十五 - 对话框和 Fragments 的使用方式](https://blog.csdn.net/i042416/article/details/122450382)

* [SAP UI5 应用开发教程之十六 - 图标 icon 的使用](https://jerry.blog.csdn.net/article/details/122453835)

* [SAP UI5 应用开发教程之十七 - 聚合绑定在 UI5 复合控件中的使用](https://blog.csdn.net/i042416/article/details/122458023)

* [SAP UI5 应用开发教程之十八 - SAP UI5 数据绑定语法里的特殊符号，以及绝对绑定和相对绑定概念详解](https://jerry.blog.csdn.net/article/details/122691944)

* [SAP UI5 应用开发教程之十九 - SAP UI5 数据类型和复杂的数据绑定](https://jerry.blog.csdn.net/article/details/122709248)

* [SAP UI5 应用开发教程之二十 - SAP UI5 的表达式绑定用法讲解](https://jerry.blog.csdn.net/article/details/122719005)

* [SAP UI5 应用开发教程之二十一 - SAP UI5 的自定义格式器 Custom Formatter](https://jerry.blog.csdn.net/article/details/122727543)

* [SAP UI5 应用开发教程之二十二 - 过滤器 filter 的开发和使用](https://jerry.blog.csdn.net/article/details/122733097)

* [SAP UI5 应用开发教程之二十三 - 列表控件的排序 Sort 和分组 Group](https://jerry.blog.csdn.net/article/details/122736505)

* [SAP UI5 应用开发教程之二十四 - 如何使用 OData 数据模型](https://jerry.blog.csdn.net/article/details/122750501)

* [SAP UI5 应用开发教程之二十五 - 使用代理服务器解决 SAP UI5 应用访问远端 OData 服务的跨域问题](https://jerry.blog.csdn.net/article/details/122766435)

* [SAP UI5 应用开发教程之二十六 - OData 服务配合 Mock 服务器的使用步骤详解](https://jerry.blog.csdn.net/article/details/122770273)

* [SAP UI5 应用开发教程之二十七 - SAP UI5 应用的单元测试工具 QUnit 介绍](https://jerry.blog.csdn.net/article/details/122774349)

* [SAP UI5 应用开发教程之二十八 - SAP UI5 应用的集成测试工具 OPA 介绍](https://jerry.blog.csdn.net/article/details/122777665)

* [SAP UI5 应用开发教程之二十九 - SAP UI5 的路由和导航功能介绍](https://jerry.blog.csdn.net/article/details/122782266)

* [SAP UI5 应用开发教程之三十 - SAP UI5 的路由过程中进行参数传递](https://jerry.blog.csdn.net/article/details/122782834)

* [SAP UI5 应用开发教程之三十一 - SAP UI5 的路由历史和路由回退(Routing back and history)](https://jerry.blog.csdn.net/article/details/122784284)

* [SAP UI5 应用开发教程之三十二 - 如何创建一个自定义 SAP UI5 控件](https://jerry.blog.csdn.net/article/details/122789898)

* [SAP UI5 应用开发教程之三十三 - SAP UI5 应用的响应式布局特性(Responsiveness)](https://jerry.blog.csdn.net/article/details/122792549)

* [SAP UI5 应用开发教程之三十四 - SAP UI5 应用基于设备类型的页面适配功能(Device Adaptation)](https://jerry.blog.csdn.net/article/details/122799506)

* [SAP UI5 应用开发教程之三十五 - 如何把本地开发的 SAP UI5 应用部署到 ABAP 服务器上](https://jerry.blog.csdn.net/article/details/122828129)

* [SAP UI5 应用开发教程之三十六 - 使用 Chrome 开发者工具 Elements 标签动态修改 CSS 类](https://jerry.blog.csdn.net/article/details/122973315)

* [SAP UI5 应用开发教程之三十七 - 使用 Chrome 开发者工具 Console 面板进行元素审查](https://blog.csdn.net/i042416/article/details/122997824)

* [SAP UI5 应用开发教程之三十八 - 使用 Chrome 开发者工具查看程序执行出错时的上下文信息](https://jerry.blog.csdn.net/article/details/122999869)

* [SAP UI5 应用开发教程之三十九 - SAP UI5 应用出现白屏的一些常见错误和分析方法分享](https://jerry.blog.csdn.net/article/details/123024694)

* [SAP UI5 应用开发教程之四十 - 如何制作包含了 component-preload.js 在内的 SAP UI5 发布版本](https://jerry.blog.csdn.net/article/details/123071595)

* [SAP UI5 应用开发教程之四十一 - Chrome 扩展 UI5 Inspector 的离线安装和使用方法](https://jerry.blog.csdn.net/article/details/123077473)

* [SAP UI5 应用开发教程之四十二 - SAP UI5 自带的 Diagnostics 诊断工具使用方法介绍](https://jerry.blog.csdn.net/article/details/123094151)

* [SAP UI5 应用开发教程之四十三 - SAP UI5 自带的 Support Assistant 工具使用方法介绍](https://jerry.blog.csdn.net/article/details/123101329)

* [SAP UI5 应用开发教程之四十四 - Label 和 Input 控件文本没有水平对齐的原因分析和解决方案](https://blog.csdn.net/i042416/article/details/123122839)

* [SAP UI5 应用开发教程之四十五 - 如何在 SAP UI5 应用里使用 jQuery 和原生的 DOM API](https://jerry.blog.csdn.net/article/details/123136635)

* [SAP UI5 应用开发教程之四十六 - 使用 Message Manager 实现开箱即用的验证(Validation)信息抛出](https://jerry.blog.csdn.net/article/details/123142913)

* [SAP UI5 应用开发教程之四十七 - 如何自定义 SAP UI5 字符串类型输入字段的校验逻辑](https://jerry.blog.csdn.net/article/details/123410743)

* [SAP UI5 应用开发教程之四十八 - 如何在 SAP UI5 应用里开发条形码扫描功能](https://jerry.blog.csdn.net/article/details/123420376)

* [SAP UI5 应用开发教程之四十九 - 如何在桌面电脑端调试运行在手机上的 SAP UI5 应用](https://jerry.blog.csdn.net/article/details/123433404)

* [SAP UI5 应用开发教程之五十 - 如何使用 Cordova 将 SAP UI5 应用生成一个能在 Android 手机上安装的混合应用](https://jerry.blog.csdn.net/article/details/123475735)

* [SAP UI5 应用开发教程之五十一 - 如何使用 Chrome 调试运行在手机上的 SAP UI5 Cordova 混合应用](https://jerry.blog.csdn.net/article/details/123489082)

* [SAP UI5 应用开发教程之五十二 - 如何使用 SAP UI5 的标准控件结合 Cordova 插件调用手机摄像头进行条形码扫描](https://blog.csdn.net/i042416/article/details/123501147)

* [SAP UI5 应用开发教程之五十三 - 如何自定义 SAP UI5 数据类型(Data Type)](https://jerry.blog.csdn.net/article/details/123684449)

* [SAP UI5 应用开发教程之五十四 - 如何将本地 SAP UI5 应用配置到本地 Fiori Launchpad 中](https://jerry.blog.csdn.net/article/details/123690190)

* [SAP UI5 应用开发教程之五十五 - 如何将本地 SAP UI5 应用通过 Node.js Express 部署到公网上](https://jerry.blog.csdn.net/article/details/123715732)

* [SAP UI5 应用开发教程之五十六 - SAP UI5 树控件(tree)的开发](https://jerry.blog.csdn.net/article/details/123727571)

* [SAP UI5 应用开发教程之五十七 - 基于 OData 注解的 Smart Field 使用方法学习](https://jerry.blog.csdn.net/article/details/123739311)

* [SAP UI5 应用开发教程之五十八 - 使用工厂方法在运行时动态创建不同类型的列表行项目控件](https://blog.csdn.net/i042416/article/details/123886385)

* [SAP UI5 应用开发教程之五十九 - 如何在 SAP UI5 应用里显示世界地图](https://blog.csdn.net/i042416/article/details/123899041)

* [SAP UI5 应用开发教程之六十 - SAP UI5 地图控件的一些高级用法](https://jerry.blog.csdn.net/article/details/123905284)

* [SAP UI5 应用开发教程之六十一 - 在 SAP UI5 应用里绘制甘特图 Gantt Chart](https://jerry.blog.csdn.net/article/details/123918417)

* [SAP UI5 应用开发教程之六十二 - 基于 OData V4 的 SAP UI5 表格控件使用方法介绍](https://jerry.blog.csdn.net/article/details/123928235)

* [SAP UI5 应用开发教程之六十三 - 基于 OData V4 的本地 Mock Server 实现的深入介绍](https://jerry.blog.csdn.net/article/details/123932828)

* [SAP UI5 应用开发教程之六十四 - 基于 OData V4 的 SAP UI5 表格控件如何实现 filter(过滤) 和 sort(排序)功能](https://jerry.blog.csdn.net/article/details/123946231)

* [SAP UI5 应用开发教程之六十五 - 基于 OData V4 的 SAP UI5 表格控件如何实现创建，编辑和保存功能](https://jerry.blog.csdn.net/article/details/123951024)

* [SAP UI5 应用开发教程之六十六 - 基于 OData V4 的 SAP UI5 表格控件如何实现删除功能](https://blog.csdn.net/i042416/article/details/123965854)

* [SAP UI5 应用开发教程之六十七 - 基于 OData V4 的 SAP UI5 List-Detail(列表-明细)布局的实现方式](https://jerry.blog.csdn.net/article/details/123969146)

* [SAP UI5 应用开发教程之六十八 - 如何实现 SAP UI5 路由失败时显示自定义的 NOT Found 页面](https://jerry.blog.csdn.net/article/details/124155362)

* [SAP UI5 应用开发教程之六十九 - 如何从 SAP UI5 Not Found 页面跳转回到正常的应用页面](https://jerry.blog.csdn.net/article/details/124171307)

* [SAP UI5 应用开发教程之七十 - 如何使用按钮控件触发页面路由跳转](https://blog.csdn.net/i042416/article/details/124318650)

* [SAP UI5 应用开发教程之七十一 - SAP UI5 页面的嵌套路由](https://jerry.blog.csdn.net/article/details/124340688)

* [SAP UI5 应用开发教程之七十二 - SAP UI5 页面路由的动画效果设置](https://blog.csdn.net/i042416/article/details/124361471)

* [SAP UI5 应用开发教程之七十三 - 使用自定义 Query 实现 SAP UI5 页面路由的书签功能](https://blog.csdn.net/i042416/article/details/124372674)

* [SAP UI5 应用开发教程之七十四 - SAP UI5 应用使用 OData V4 显示 Table 表格数据的一个陷阱](https://blog.csdn.net/i042416/article/details/124458638)

* [SAP UI5 应用开发教程之七十五 - 如何采用SAP UI5 主从表格的联动技术显示复杂表格内容](https://blog.csdn.net/i042416/article/details/124501745)

* [SAP UI5 应用开发教程之七十六 - 如何实现 SAP UI5 的 Lazy Loading(延迟加载，懒加载)](https://blog.csdn.net/i042416/article/details/124545027)

* [SAP UI5 应用开发教程之七十七 - SAP UI5 动态页面路由的高级用法：路由记录 routes 和 target 的一对多关系](https://blog.csdn.net/i042416/article/details/124548400)

* [SAP UI5 应用开发教程之七十八 - 如何通过 url 保持 SAP UI5 搜索的状态，让其支持书签功能](https://blog.csdn.net/i042416/article/details/124554155)

* [SAP UI5 应用开发教程之七十九 - 采用测试驱动开发理念(Test Driven Development)进行 SAP UI5 应用的功能开发(一)](https://blog.csdn.net/i042416/article/details/124563162)

* [SAP UI5 应用开发教程之八十 - 采用测试驱动开发理念(Test Driven Development)进行 SAP UI5 应用的功能开发(二)](https://blog.csdn.net/i042416/article/details/124567472)

* [SAP UI5 应用开发教程之八十一 - 采用 OPA5 进行 SAP UI5 集成测试(Integration Test)的一个例子](https://blog.csdn.net/i042416/article/details/124584580)

* [SAP UI5 应用开发教程之八十二 - 采用 OPA5 开发支持页面跳转的 SAP UI5 集成测试用例](https://jerry.blog.csdn.net/article/details/124624593)

* [SAP UI5 应用开发教程之八十三 - SAP UI5 的自动化测试套件页面的开发步骤介绍](https://blog.csdn.net/i042416/article/details/124643848)

* [SAP UI5 应用开发教程之八十四 - 如何指定 SAP UI5 应用程序基于某个特定的版本运行](https://blog.csdn.net/i042416/article/details/124698789)

* [SAP UI5 应用开发教程之八十五 - 如何用 OPA5 编写测试用例来测试用户输入文本的功能](https://blog.csdn.net/i042416/article/details/124709547)

* [SAP UI5 应用开发教程之八十六 - 动手开发一个最简单的本地 Mock 数据服务器](https://jerry.blog.csdn.net/article/details/124715670)

* [SAP UI5 应用开发教程之八十七 - 如何让 SAP UI5 Mock 服务器支持自定义 url 参数](https://blog.csdn.net/i042416/article/details/124751818)

* [SAP UI5 应用开发教程之八十八 - SAP UI5 Mock 服务器如何实现自定义 Function Import](https://blog.csdn.net/i042416/article/details/124765653)

* [SAP UI5 应用开发教程之八十九 - 如何给 SAP UI5 列表控件增添多个图形界面的过滤器](https://blog.csdn.net/i042416/article/details/124789417)

* [SAP UI5 应用开发教程之九十 - 基于 OData V2 的 SAP UI5 List-Detail(列表-明细)布局的实现方式](https://blog.csdn.net/i042416/article/details/124815531)

* [SAP UI5 应用开发教程之九十一 - 如何使用客户端 JSON 模型构建一个 Master-Detail-Detail 布局中的列表页面](https://blog.csdn.net/i042416/article/details/124980062)

* [SAP UI5 应用开发教程之九十二 - 基于 SAP UI5 JSONModel 客户端模型的列表分页显示(Table Pagination)前提](https://blog.csdn.net/i042416/article/details/124990504)

* [SAP UI5 应用开发教程之九十三 - 基于 JSONModel 数据模型的列表控件显示数据的深入讨论](https://blog.csdn.net/i042416/article/details/125011617)

* [SAP UI5 应用开发教程之九十四 - 基于 JSONModel 数据模型的 SAP UI5 列表控件分页显示数据的完整解决方案](https://blog.csdn.net/i042416/article/details/125031649)

* [SAP UI5 应用开发教程之九十五 - SAP UI5 下拉菜单(Select) 控件的使用方式](https://jerry.blog.csdn.net/article/details/125044943)

* [SAP UI5 应用开发教程之九十六 - SAP UI5 列表控件分页显示数据时，如何自定义分页大小](https://blog.csdn.net/i042416/article/details/125055559)

* [SAP UI5 应用开发教程之九十七 - 如何使用客户端 JSON 模型构建一个 Master-Detail-Detail 布局中的明细页面](https://blog.csdn.net/i042416/article/details/125114902)

* [SAP UI5 应用开发教程之九十八 - 从 viewId 这个属性谈起，聊聊 SAP UI5 的 HTML 源代码生成机制](https://blog.csdn.net/i042416/article/details/125119020)

* [SAP UI5 应用开发教程之九十九 - 深入探讨 SAP UI5 本地开发环境里的 package.json 和 ui5.yaml](https://blog.csdn.net/i042416/article/details/125353133)

* [SAP UI5 应用开发教程之一百 - 如何修改 SAP UI5 框架的源代码实现，以及使用本地部署的 SAP UI5 SDK](https://blog.csdn.net/i042416/article/details/125356519)

* [SAP UI5 应用开发教程之一百零一 - SAP UI5 应用的 Locale 决定机制](https://jerry.blog.csdn.net/article/details/125381962)

* [SAP UI5 应用开发教程之一百零二 - SAP UI5 应用的打印(Print)功能实现详解](https://blog.csdn.net/i042416/article/details/125411347)

* [SAP UI5 应用开发教程之一百零三 - 如何在 SAP UI5 应用中消费第三方库](https://blog.csdn.net/i042416/article/details/125415071)

* [SAP UI5 应用开发教程之一百零四 - SAP UI5 表格控件的支持复选(Multi-Select)以及如何用代码一次选中多个表格行项目](https://blog.csdn.net/i042416/article/details/125564041)

* [SAP UI5 应用开发教程之一百零五 - SAP UI5 Master-Detail 布局模式的联动效果实现明细介绍](https://blog.csdn.net/i042416/article/details/125577667)

* [SAP UI5 应用开发教程之一百零六 - 如何提高 SAP UI5 应用路由 url 的可读性](https://blog.csdn.net/i042416/article/details/125583012)

* [SAP UI5 应用开发教程之一百零七 - SAP UI5 OverflowToolbar 容器控件以及 resize 事件处理的一些细节介绍](https://jerry.blog.csdn.net/article/details/125609805)

* [SAP UI5 应用开发教程之一百零八 - SAP UI5 图片显示控件 Avatar 的使用方式介绍](https://jerry.blog.csdn.net/article/details/125759976)

* [SAP UI5 应用开发教程之一百零九 - 使用 SAP UI5 FileUploader 控件上传本地文件](https://blog.csdn.net/i042416/article/details/125979700)

* [SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe](https://blog.csdn.net/i042416/article/details/126024207)

* [SAP UI5 应用开发教程之一百一十一 - SAP UI5 FileUploader 控件实现本地文件上传，接收服务器端的响应时遇到跨域访问错误](https://blog.csdn.net/i042416/article/details/126024207)

* [SAP UI5 应用开发教程之一百一十二 - 使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误](https://blog.csdn.net/i042416/article/details/126034853)

* SAP UI5 应用开发教程之一百一十三 - 正在写作中......

## 说明

Jerry 从 2014 年加入 SAP成都研究院 CRM Fiori 开发团队之后开始接触 SAP UI5，曾经在 SAP 社区和“汪子熙”微信公众号上发表过多篇关于 SAP UI5 工作原理和源码解析的文章。

在 Jerry 这篇文章 [对 SAP UI5 一无所知的新手，从哪些材料开始学习比较好？](https://blog.csdn.net/i042416/article/details/116347763) 曾经提到，Jerry 也是从 SAP UI5 菜鸟一路走过来，深知只有 ABAP 开发背景的开发者，向 SAP UI5 开发领域转型的不易，因此我在业余时间设计了这份适合 `SAP UI5 不同水平`的学习者的学习教程，把开发一个完整的 SAP UI5 应用的流程，拆分成若干个步骤，力求每个步骤里，把涉及到的知识点都涵盖到。

这些知识点可能不像我的 UI5 源码分析系列文章那么深入，但力求做到深入浅出，重要的知识点都配上详细的截图来辅助文字的介绍，便于教程学习者的理解。

本教程每一个步骤的源代码，都存放在我的 [Github](https://github.com/wangzixi-diablo/ui5-tutorial) 上，分别用文件夹 01，02，03 等等来标识，例如步骤 1 的源代码在[这里](https://github.com/wangzixi-diablo/ui5-tutorial/tree/main/01)。

![](https://img-blog.csdnimg.cn/img_convert/c7bad3447ae1849d56da2f9ae2f4a6e8.png)

每一个步骤均是前一步骤的基础上，添加了若干新特性。建议零基础或者对 SAP UI5 知之甚少的 `SAP UI5 初学者`，按照顺序从第一个步骤开始循序渐进地学习，把这些代码下载到本地，配合教程的文字讲解，自己动手，以加深理解。

对于已经`有一定基础`的 SAP UI5 开发人员，可以通过本文的目录，跳过前面一部分比较基础的章节，直接挑选对自己工作项目有关，或者包含某些知识点自己尚未掌握的章节来有针对性地学习。

大家如果对教程的每个步骤有任何疑问，欢迎在教程对应的步骤文章里给我评论，进行留言。我虽然平时开发工作很忙，但是保证会定期查看大家给我留下的评论，对于里面涉及到的技术疑问，我一定会`抽时间做出解答`。

本教程我们已经花了三个步骤的篇幅，介绍了 SAP UI5 FileUploader 的使用方法，实现原理，以及引起跨域访问错误的根源。

* [SAP UI5 应用开发教程之一百零九 - 使用 SAP UI5 FileUploader 控件上传本地文件](https://blog.csdn.net/i042416/article/details/125979700)

* [SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe](https://blog.csdn.net/i042416/article/details/126024207)

* [SAP UI5 应用开发教程之一百一十一 - SAP UI5 FileUploader 控件实现本地文件上传，接收服务器端的响应时遇到跨域访问错误](https://blog.csdn.net/i042416/article/details/126024207)

![](https://img-blog.csdnimg.cn/img_convert/a4a418ad595d89e55e9c6c3f52a3f504.png)

我们再次回顾一下这个跨域访问的错误根源：

(1) 我们开发的 SAP UI5 应用，向 XML 视图里，FileUploader 控件的 `uploadUrl` 硬编码的 `localhost:3003` 发起文件上传请求，如下图图例 1.

(2) 监听在 3003 端口上的文件服务器(下图右边)，接收到这个上传请求，将响应返回给 SAP UI5 框架创建的隐藏 iframe 的 body 节点中去(细节在之前的步骤[SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe](https://blog.csdn.net/i042416/article/details/126024207)里有介绍)。
![](https://img-blog.csdnimg.cn/img_convert/d79da390ce46c79767d4df569697ce59.png)

(3) 因为这个隐藏的 iframe 接收的响应来自 localhost:3003, 因此无法通过来自 localhost:8080 的 SAP UI5 app 访问，会遇到错误消息：

![](https://img-blog.csdnimg.cn/img_convert/5c7afb33e4eaf1d7771a01ae60b79ab3.png)

> Uncaught DOMException: Blocked a frame with origin “http://localhost:8080” from accessing a cross-origin frame.
at eval (eval at (https://sapui5.hana.ondemand.com/resources/sap/ui/unified/FileUploader-dbg.js:1890:24), :1:31)
at fnClass. (https://sapui5.hana.ondemand.com/resources/sap/ui/unified/FileUploader-dbg.js:1890:24)
at HTMLIFrameElement.dispatch (https://sapui5.hana.ondemand.com/resources/sap/ui/thirdparty/jquery-dbg.js?eval:5430:27)
at elemData.handle (https://sapui5.hana.ondemand.com/resources/sap/ui/thirdparty/jquery-dbg.js?eval:5234:28)

解决这个跨域访问错误有很多种思路。

一种最直接的思路，就是将 SAP UI5 和文件服务器，部署在同一台主机的同一台端口号上，如下图所示，这样 SAP UI5 App 和文件服务器之间的交互，属于同源资源的互相访问，可以不加任何特殊处理地正常进行。

![](https://img-blog.csdnimg.cn/img_convert/ab8c20d7ed7548641baebbcad44c02c2.png)

另一种引入代理服务器，或者说负载均衡服务器的方法是，在仍然保留 SAP UI5 应用运行的 localhost:8080 本地服务器和文件服务器 localhost:3003 `不变`的前提下，将新引入的代理服务器 localhost:8085，作为用户访问 SAP UI5 应用，进行文件上传的操作入口。

![](https://img-blog.csdnimg.cn/img_convert/e81fe5eafbdbf022b292c2b2b4562686.png)

这两种方法的具体介绍，参考笔者这篇[文章](https://blog.csdn.net/i042416/article/details/126034853)。

本教程我们已经花了三个步骤的篇幅，介绍了 SAP UI5 FileUploader 的使用方法，实现原理，以及引起跨域访问错误的根源。

* [SAP UI5 应用开发教程之一百零九 - 使用 SAP UI5 FileUploader 控件上传本地文件](https://blog.csdn.net/i042416/article/details/125979700)

* [SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe](https://blog.csdn.net/i042416/article/details/126024207)

* [SAP UI5 应用开发教程之一百一十一 - SAP UI5 FileUploader 控件实现本地文件上传，接收服务器端的响应时遇到跨域访问错误](https://blog.csdn.net/i042416/article/details/126024207)

![](https://img-blog.csdnimg.cn/img_convert/084b3da5ee6dfe3329b961a60637806e.png)

我们再次回顾一下这个跨域访问的错误根源：

(1) 我们开发的 SAP UI5 应用，向 XML 视图里，FileUploader 控件的 `uploadUrl` 硬编码的 `localhost:3003` 发起文件上传请求，如下图图例 1.

(2) 监听在 3003 端口上的文件服务器(下图右边)，接收到这个上传请求，将响应返回给 SAP UI5 框架创建的隐藏 iframe 的 body 节点中去(细节在之前的步骤[SAP UI5 应用开发教程之一百一十 - SAP UI5 FileUploader 控件深入介绍 - 为什么需要一个隐藏的 iframe](https://blog.csdn.net/i042416/article/details/126024207)里有介绍)。
![](https://img-blog.csdnimg.cn/img_convert/aa78e8ed51f8198610a5665db4ee00ff.png)

(3) 因为这个隐藏的 iframe 接收的响应来自 localhost:3003, 因此无法通过来自 localhost:8080 的 SAP UI5 app 访问，会遇到错误消息：

![](https://img-blog.csdnimg.cn/img_convert/e09daca72ea610a60e6b4939228235d2.png)

> Uncaught DOMException: Blocked a frame with origin “http://localhost:8080” from accessing a cross-origin frame.
at eval (eval at (https://sapui5.hana.ondemand.com/resources/sap/ui/unified/FileUploader-dbg.js:1890:24), :1:31)
at fnClass. (https://sapui5.hana.ondemand.com/resources/sap/ui/unified/FileUploader-dbg.js:1890:24)
at HTMLIFrameElement.dispatch (https://sapui5.hana.ondemand.com/resources/sap/ui/thirdparty/jquery-dbg.js?eval:5430:27)
at elemData.handle (https://sapui5.hana.ondemand.com/resources/sap/ui/thirdparty/jquery-dbg.js?eval:5234:28)

解决这个跨域访问错误有很多种思路。

一种最直接的思路，就是将 SAP UI5 和文件服务器，部署在同一台主机的同一台端口号上，如下图所示，这样 SAP UI5 App 和文件服务器之间的交互，属于同源资源的互相访问，可以不加任何特殊处理地正常进行。

![](https://img-blog.csdnimg.cn/img_convert/eafd3f8ce517c76a5ddf276dafb39750.png)

另一种引入代理服务器，或者说负载均衡服务器的方法是，在仍然保留 SAP UI5 应用运行的 localhost:8080 本地服务器和文件服务器 localhost:3003 `不变`的前提下，将新引入的代理服务器 localhost:8085，作为用户访问 SAP UI5 应用，进行文件上传的操作入口。

![](https://img-blog.csdnimg.cn/img_convert/82d5ec39cc5a7a4ff00cddf34949cc62.png)

这两种方法的具体介绍，参考笔者这篇[文章](https://blog.csdn.net/i042416/article/details/126034853)。

ITPub博客

使用自开发的代理服务器解决 SAP UI5 FileUploader 上传文件时遇到的跨域访问错误

最新文章