简介：面向Oracle数据库开发者与低代码平台学习者的APEX实战指南，帮助读者从零搭建环境并逐步掌握企业级Web应用开发。内容以一份doc文档承载，压缩包约8.11MB，围绕系统探究与开发两条主线展开：涵盖APEX简介、环境搭建、账户与权限管理，以及页面布局美化、常用控件、Report增删改、文件上传下载、CSS与JS客户端脚本、图表报表可视化等模块，并延伸至插件应用、部署、调试技巧与EBS集成配置，目录层次清晰，便于按章节系统学习或按需查阅。目前已有1594人学习下载，适合希望快速上手APEX、提升开发效率与质量的初中级开发者对照实践。

1. 从一次 ADMIN 登录失败说起：Oracle APEX 4.2.5 环境搭建到底卡在哪

装 Oracle APEX 最玄学的一幕，不是数据库起不来，而是所有安装步骤都跑完了，浏览器打开http://server:8888/apex/apex_admin，输入 ADMIN 和刚改过的密码，页面转一圈又弹回登录框。你以为是密码错了，改密码、重启数据库、查监听，折腾半天，最后发现是 11g 自带的 APEX 3.0 遗留用户没清干净，授权校验还走在旧版本上。这套环境在 EBS 二次开发场景里太常见了：RedHat + Oracle 11g + APEX 4.2.5，用嵌入式 PL/SQL 网关省掉独立 HTTP 服务器，装好了能直接在数据库里做页面、报表、Tabular Form 增删改。装不好就是 404、登录死循环、APEX_PUBLIC_USER 锁死三连。下面按我实际走通的顺序，把版本选择、卸载旧版、建表空间、装 4.2.5、配网关、账户分层、验证登录一路写清楚，新手能照抄，熟手能对出版本差异。

2. 装前把版本和环境钉死：APEX 4.2.5 与 Oracle 11g 的搭配取舍

2.1 为什么选 4.2.5 而不是 11g 自带的 3.0

Oracle 11g release 1 和 release 2 安装完，数据库里默认就带着 APEX 3.0。很多人图省事直接用，结果一进页面布局就翻车：3.0 里 Region 的 Column 属性是全局的，改一个子区域的列宽，整张 Body 的表格跟着变，做复杂布局基本靠硬扛。4.2.5 把 Grid Layout 下放到每个子区域，Start New Grid、Start New Row、Column三个属性可以逐层配置，子子区域都能单独重排。项目上如果用的是 4.1.1，布局这块会明显憋屈，能升到 4.2.5 就升。

版本对照我一般按这张表确认，装之前先对一遍，省得装到一半发现数据库版本不匹配：

数据库版本这块有个硬分界：11g 自带 PL/SQL 网关，配置简单，直接提供 HTTP 功能；10g 就必须上 mod_plsql 插件或者 APEX Listener 去接专业 HTTP 服务器。本文走的是 11g 嵌入式网关路线，10g 环境别照抄这一段。

2.2 浏览器和客户端的前置要求

APEX 是纯浏览器端开发，客户端不需要装任何东西，但浏览器有底线：必须支持 JavaScript、HTML 4.0 和 CSS 1.0。官方建议 IE 7.0 以上、Firefox 3.6 以上、Chrome 4.0 以上、Safari 4.0 以上。放到今天这些版本都算古董，实际用现代浏览器打开 4.2.5 的管理界面一般也能跑，但老版本 IE 的兼容模式反而容易把 Grid Layout 的表格渲染搞乱，我一般固定用 Chrome 或 Firefox，别混着切。

学习基础这块提前说清楚：SQL 和 PL/SQL 是必须的，APEX 的页面逻辑、验证、Process、Dynamic Action 里执行的都是 PL/SQL；HTML 基础在深入做布局和 CSS/JS 定制时绕不开。如果这两块是空白，装完也只能点界面，改不动逻辑。

2.3 虚拟机环境的保留策略

这套环境跑在 VMware 8.0 的虚拟机上，装完后如果直接关机，下次开机数据库实例、网关配置、环境变量都得重新捋一遍。我的习惯是把虚拟机状态置为挂起，下次恢复后数据库和 PL/SQL 网关都还在原状态，省掉重复配置。这个动作看着小，但能避免很多“上次明明配好了这次又 404”的假故障。

3. 卸载旧版再装 4.2.5：表空间、解压与核心安装步骤

3.1 先清 APEX 3.0 遗留用户，这是登录死循环的根

11g 自带的 APEX 3.0 必须先卸干净，否则 4.2.5 装完后授权校验可能还指向旧版本的用户。操作顺序是：先跑 3.0 的卸载脚本，确认全部 OK 后，进apex目录执行清理，把残留文件删掉。

# 进入 APEX 安装目录，清掉旧版本残留文件 cd $ORACLE_HOME/apex rm -rf *.* # 卸载完成后，用 DBA 用户登录数据库，检查是否还有 3.0 遗留用户 sqlplus / as sysdba

-- 查 APEX 相关用户，重点看有没有 3.0 时代的残留 SELECT username FROM dba_users WHERE username LIKE 'APEX%';

rm -rf *.*这条命令执行前一定确认当前目录就是$ORACLE_HOME/apex，路径错了就是灾难。查用户这步别省，后面登录失败时你会感谢自己提前看过这份清单。我踩过的坑是：卸载脚本跑完以为干净了，结果dba_users里还挂着旧版用户，4.2.5 装完 ADMIN 登录一直过不去，最后就是靠这条查询定位到遗留用户，DROP USER ... CASCADE清掉才通。

3.2 建独立表空间，别让 APEX 挤在 SYSTEM 里

APEX 的所有页面、组件、元数据都存数据库表里，给它单独一个表空间，后续备份、扩容、迁移都清爽。用 DBA 用户执行：

CREATE TABLESPACE apex01 DATAFILE '/d01/oracle/[SID]/db/apps_st/data/apex01.dbf' SIZE 100M AUTOEXTEND ON NEXT 100M MAXSIZE 1000M;

DATAFILE路径里的[SID]换成实际实例名，路径要落在有写权限的存储上。SIZE 100M是初始大小，AUTOEXTEND ON NEXT 100M MAXSIZE 1000M表示每次自动扩 100M、上限 1G。开发环境这个量够用，生产环境按页面数量和数据量往上调，别卡着 1G 上限，APEX 元数据涨起来比想象中快。

3.3 上传解压与安装脚本执行

把Apex_4.2.5.zip上传到$ORACLE_HOME下，解压到apex目录，然后以 DBA 身份进解压目录跑安装脚本。安装过程会创建 APEX 自己的 schema（4.2.5 对应 APEX_040200），这一步耗时取决于数据库性能，别中途打断。

# 上传后解压到 $ORACLE_HOME/apex cd $ORACLE_HOME unzip Apex_4.2.5.zip -d apex cd apex # 以 DBA 身份连接并执行安装 sqlplus / as sysdba

-- 在 SQL*Plus 中执行 APEX 安装脚本（脚本名以解压目录实际为准） @apexins.sql APEX01 APEX01 TEMP /i/

apexins.sql后面跟的三个参数分别是 APEX 表空间、APEX 文件表空间、临时表空间，最后/i/是图片虚拟目录前缀。表空间名要和 3.2 建的一致，写错了安装会报错退出。安装完成后先别急着开浏览器，把下面这步解锁做完。

3.4 解锁 ANONYMOUS 与 APEX_PUBLIC_USER

APEX 的匿名访问和公共用户默认是锁定状态，不解锁网关请求进不来：

-- 解锁匿名用户和公共用户 ALTER USER ANONYMOUS ACCOUNT UNLOCK; ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

ADMIN 用户的密码要设复杂：大写、小写、数字、特殊符号都得有。这不是形式主义，APEX 管理入口暴露在 8888 端口上，弱密码等于把整个开发环境敞开。改完密码后如果登录还是失败，先别怀疑密码，回到 3.1 查遗留用户。

3.5 可选装中文语言包

团队里如果中文界面更顺手，安装完主程序后可以再跑中文语言包脚本。语言包不是必装项，装了之后管理界面和开发界面的菜单会切到中文，但部分插件和第三方组件的翻译不全，混着中英文看也正常。我的建议是：自己用可以装，交付给不熟英文的同事也装，纯技术团队保持英文反而少一层翻译歧义。

4. 配嵌入式 PL/SQL 网关：8888 端口、404 排查与参数调整

4.1 网关配置与端口确认

11g 的嵌入式 PL/SQL 网关是 APEX 能通过浏览器访问的关键。配置完成后，管理入口是http://server:8888/apex/apex_admin，普通访问入口是http://server:8888/apex。8888 是网关默认监听端口，如果被占用或者被防火墙挡了，浏览器表现就是连不上或者超时，不是 APEX 本身的问题。

配置完网关后还要给 APEX_040200 用户授连接权限，允许它连到任意主机：

-- 给 APEX 引擎用户授予连接权限 BEGIN DBMS_NETWORK_ACL_ADMIN.CREATE_ACL( acl => 'apex_acl.xml', description => 'APEX network access', principal => 'APEX_040200', is_grant => TRUE, privilege => 'connect' ); END; /

这段 ACL 配置是让 APEX 引擎用户具备出站连接能力，插件调用外部服务、邮件发送这类功能依赖它。principal写 APEX 引擎用户名，4.2.5 就是APEX_040200，版本不同这个名字会变，装之前用SELECT username FROM dba_users WHERE username LIKE 'APEX%'确认一下。

4.2 HTTP 404 的两种典型成因

装完访问管理页报 404，先分清是网关没起还是路径不对。网关没开的话，用 DBA 身份把 PL/SQL 网关的监听启起来；路径不对的话，检查访问 URL 是不是少了/apex前缀。我遇到过的 404 基本都是网关进程没起来，数据库重启后网关不会自动跟着起，需要手动拉一次。

提示：虚拟机挂起恢复后，如果 404 复现，优先检查网关状态，而不是重装 APEX。重装一次二十分钟起步，查网关两分钟。

4.3 参数调整与安装后的收尾

安装收尾阶段还有几项参数要改，主要是会话和请求相关的数据库参数，保证 APEX 页面渲染和提交时的资源够用。具体参数值按数据库实际内存和并发开发人数调，开发环境不用抠太细，但别用默认值硬扛多人同时开页面。

收尾检查清单我一般按这个顺序过：网关进程在跑、8888 端口可访问、ANONYMOUS 和 APEX_PUBLIC_USER 已解锁、ADMIN 密码已改、遗留用户已清。五项全过再开浏览器，能省掉大量来回试错。

5. 账户分层与开发环境落地：ADMIN、Workspace、Developer 怎么分

5.1 ADMIN 只做管理，不碰开发

ADMIN 是 APEX 的超级管理员，职责是创建、删除、修改 Workspace 以及 Workspace 管理员，不直接进业务开发。装完后第一件事是用 ADMIN 建 Workspace：比如建一个名为jjl的 Workspace，Schema 指向 EBS 的apps，同时创建该 Workspace 的管理员jjl。Schema 选apps是为了后续和 EBS 集成时直接访问 EBS 的表和视图，这是 EBS 二次开发场景的标准做法。

5.2 Workspace 内再分 Developer 和最终用户

用 Workspace 管理员jjl登录后，在 Workspace 里创建开发用户和 App 最终用户。开发用户负责建 Application、页面、报表；最终用户只登录使用，不给开发权限。这个分层和 EBS 里职责分离是一个思路：ADMIN 管平台，Workspace 管理员管工程，Developer 管页面，最终用户管业务。

账户关系理清楚后，开发时的映射关系也就顺了：一个 Workspace 对应数据库的一个 Schema，可以理解成一个工程；工程里的每个 Application 类似 EBS 里的一个 Form，Form 里有多个窗口，Application 里有多个页面。这个类比在跟 EBS 开发同事沟通时特别好用，他们一听就懂。

5.3 Application 的登录认证机制选择

建 Application 时会让选认证方式，APEX 自带 7 种。EBS 集成场景下常用两种：Application Express Accounts 和 HTTP Header Variable。前者要求用户输入 APEX 自己的用户名密码，适合独立应用；后者从 HTTP 头里取认证信息，适合已经有一套统一认证体系的场景。选错了后期可以改，但改认证方式会牵动页面权限和会话逻辑，建 Application 时就想清楚，别等页面做了一半再换。

5.4 Page 0 放全局变量

每个 Application 都有一个 Page 0，作为全局页存在。全局变量、全局常量放这里，按类型分区域管理，这些区域在界面上不显示，类似 HTML 里的 hidden。开发时养成习惯：跨页面用的值统一放 Page 0，别散落在各个页面里，后期排查问题时能少翻一半页面。

6. 避坑与排查：APEX 4.2.5 安装和登录的五个血泪记录

6.1 ADMIN 登录一直失败，密码改了也没用

现象：安装全部完成，管理页能打开，输入 ADMIN 和正确密码后跳回登录页，反复改密码、重启数据库都无效。

原因：11g 自带的 APEX 3.0 遗留用户没清干净，授权校验还走在旧版本的用户上。3.1 的卸载步骤如果只跑了脚本没查dba_users，很容易漏。

解决：用 DBA 用户查SELECT username FROM dba_users WHERE username LIKE 'APEX%'，把 3.0 时代的遗留用户逐个DROP USER ... CASCADE清掉。清的时候注意别把 4.2.5 的APEX_040200一起 drop 了，我干过这事，结果只能重装一遍。

6.2 误删 APEX_040200 导致整套重装

现象：清遗留用户时手快，把APEX_040200也 drop 了，之后所有 APEX 页面报错，管理页直接不可用。

原因：APEX_040200是 4.2.5 的引擎用户，所有 PL/SQL 对象挂在它下面，删了等于把引擎拆了。

解决：没有捷径，重新跑 3.3 的安装脚本重装。教训是清用户前先把dba_users的完整清单导出来，对照版本号确认哪些是旧的、哪些是新的，别凭印象删。

6.3 访问管理页报 HTTP 404

现象：安装完成，浏览器打开http://server:8888/apex/apex_admin返回 404。

原因：两种可能，一是嵌入式 PL/SQL 网关没启动，二是 URL 路径写错。虚拟机挂起恢复后网关不自动起，是最常见的一种。

解决：先用 DBA 身份确认网关进程状态，没起就手动启起来；网关正常再检查 URL 是否带/apex前缀。别一看到 404 就重装，先查网关。

6.4 页面布局改一个区域，整张表跟着变

现象：在 4.1.1 或 3.0 环境里调 Region 的 Column 属性，改一个子区域，同 Body 下其他区域的列宽全乱。

原因：老版本 Region 的 Column 属性是全局的，整个 Body 共用一套表格布局，没有子区域级的 Grid Layout。

解决：升到 4.2.5，用每个区域自己的Start New Grid、Start New Row、Column三个属性逐层配置。Start New Grid为 Yes 表示当前对象开一张新表，Start New Row为 Yes 表示换行，Column指定落在第几列。复杂布局就是这三个属性的组合，配之前先在纸上画一遍表格结构，比在界面上反复试快得多。

6.5 Tabular Form 提交后数据没更新

现象：Tabular Form 里改了数据，点 Apply Change 后页面刷新，数据没变。

原因：Process 没绑到按钮上，或者 Process 的执行时机（After Submit）和按钮的提交动作没对上。

解决：检查 Apply Change 按钮对应的 Process，确认 Process 类型、执行点、条件都正确。Tabular Form 的增删改本质是视图上的多行操作，Process 里写的 PL/SQL 要能处理多行提交，别按单行逻辑写。这块和 EBS Form 的基于视图开发是一个思路，写过 EBS Form 的同事上手会快很多。

7. 装完怎么验证跑通：从登录到第一个 Tabular Form 的完整自检

装完不验证等于没装。我的自检顺序是从外到内：先确认网关和登录，再确认 Workspace 和权限，最后跑一个带增删改的最小页面，三层全过才算这套环境真的能用。

第一层，网关和登录。浏览器打开http://server:8888/apex/apex_admin，用 ADMIN 登录，能进管理界面说明网关、端口、认证链路都通。再打开http://server:8888/apex，确认普通入口也能访问。两个入口都通，第一层过。

第二层，Workspace 和账户。用 ADMIN 建好的 Workspace 管理员登录，进 Workspace 后确认 Developer 用户能创建 Application，最终用户能登录但不能进开发界面。权限分层验证的重点是“该能进的能进，该拦的拦住”，只测能进不测拦截，等于没测。

第三层，跑一个最小 Tabular Form。建一张测试表、一个视图，页面上建 Tabular Form，绑一个 Apply Change 按钮和对应 Process，改一行数据提交，确认数据库里真的变了。再故意填一个不存在的 class_name，确认校验能拦住并报错。这一层过了，说明页面渲染、表单提交、Process 执行、校验逻辑整条链路都通。

验证时我习惯把关键检查点记成一张小表，出问题时对着表逐项打勾，比凭记忆排查快：

这套自检我每次装完新环境都强制走一遍，哪怕前面每一步都显示成功。有一次就是前面全绿，第三层提交时发现 Process 没绑上按钮，页面看着正常，数据就是不落库，这种问题只有跑一遍真实提交才暴露得出来。从那以后我每次装完 APEX，不管多赶时间，第三层的最小 Tabular Form 都必跑，不跑完不交付。希望这套顺序能帮到你，少在登录死循环和 404 上耗时间。

本文还有配套的精品资源，点击获取