codebase 属性指向 java 类文件或 jar 包的基准 url,用于旧版 和部分 标签中解析 code 与 archive 的相对路径,仅在已废弃的 java 浏览器插件环境中生效。

codebase 属性到底指向哪个路径
codebase 是 HTML 中 <applet></applet>(已废弃)和部分旧版 <object></object> 标签的属性,它**不指向 JS 或现代前端资源路径,而是指定 Java 类文件(.class)或 JAR 包的基准 URL**。浏览器用它来解析 archive 和 code 中的相对路径。
常见误解是把它当成类似 base href 或 Webpack 的 publicPath,但实际作用窄得多——只服务于 Java Applet 加载器(JVM 插件),且仅在启用 Java 浏览器插件的极旧环境(如 IE6–8 + JRE 6/7)中生效。
codebase 在
假设页面 URL 是 https://example.com/pages/demo.html,有如下代码:
<applet code="MyApplet.class" codebase="/java/" archive="lib/utils.jar"></applet>
此时 JVM 会按以下顺序尝试加载:
-
codebase值为/java/→ 解析为绝对路径https://example.com/java/ -
code="MyApplet.class"→ 实际请求https://example.com/java/MyApplet.class -
archive="lib/utils.jar"→ 相对于codebase,即https://example.com/java/lib/utils.jar
注意:codebase 不影响页面其他资源(CSS/JS/图片),也不参与 CSP 或同源策略的额外校验——它只是 JVM 插件内部的路径拼接前缀。
在
某些老版本 IE 允许在 <object></object> 中用 codebase 指向 JRE 下载地址(如 http://java.sun.com/update/1.6.0/jinstall-6uX-windows-i586.cab),用于自动提示安装 Java 插件。但这不是路径解析用途,而是触发 ActiveX 控件安装的“引导 URL”。
容易踩的坑包括:
-
codebase值末尾是否加/:不加会导致路径拼接错误(如codebase="java"+archive="a.jar"→ 请求javaa.jar) - 混用
codebase和base标签:后者对<applet></applet>无效,纯属干扰 - 现代浏览器(Chrome 45+、Firefox 52+、Edge)已彻底移除 Java 插件支持,设了
codebase也无任何效果,控制台也不会报错
替代方案与现实建议
如果你正在维护遗留系统并遇到 codebase 加载失败,优先确认:
- 目标用户是否仍在使用支持 Java Applet 的旧环境(如内网 IE8 + JRE 1.6)
- HTTP Server 是否正确返回
.class文件的 MIME 类型(应为application/java-vm,而非text/plain) - 路径是否被反向代理或 CDN 重写(例如 Nginx 把
/java/重定向到了/legacy/java/,但没同步更新codebase)
若需迁移,不要试图复刻 codebase 逻辑——改用 WebAssembly、Canvas 或轻量级 JS 库重写交互逻辑更可靠。Java Applet 的路径机制本身没有现代等价物,硬套会绕进死胡同。
真正关键的不是路径怎么写,而是谁还在执行这段代码。查 UA、看控制台网络面板里有没有 MyApplet.class 的 404,比反复调试 codebase 值有用得多。











