最近帮朋友收拾一个老内网系统，里面用到 HTTP File Upload ActiveX 控件做文件上传，结果他折腾一下午没跑起来，跑来问我。说实话这玩意儿现在不算主流了，但很多单位的老项目、政务内网、还有工厂里的管理系统还在用，绕不开。我把这次从装控件到调通接口的过程整理了一下，顺便把 HTTP File Upload ActiveX 常见的坑都写出来，你要是也接手了类似的项目，照着看能省不少时间。
类别： FTP工具 大小：855KB 语言：中文
先搞清楚这控件到底是干嘛的
名字挺唬人，说白了就是一个跑在 IE 内核里的 HTTP File Upload ActiveX 组件，负责把本地文件通过 HTTP 协议传到服务器。它跟现在网页里那种 input type=file 不一样，普通浏览器控件受限于安全策略，拿不到完整路径、也没法批量选文件夹，而这个 ActiveX 控件权限更高，能直接读本地目录、支持大文件分块、还能显示上传进度条。
所以你会看到很多老系统点名要用它，尤其是需要批量上传、断点续传或者要读取文件真实路径做校验的场景。理解这一点，后面配置参数就不容易懵。
安装和注册，第一步就容易卡住
很多人拿到控件包直接双击安装，装完网页还是提示“未找到对象”，问题基本都出在注册这一步。HTTP File Upload ActiveX 是 COM 组件，得用管理员身份打开命令行，敲 regsvr32 加控件 dll 的完整路径去注册。路径里要是有空格，记得用英文引号括起来，不然命令直接报错。
还有一点，64 位系统要留意控件位数，32 位浏览器调 32 位 dll，别装混了。我那次就是朋友在 64 位系统上注册了 32 位控件，用 64 位 IE 打开死活不认，换成 32 位进程立马就好了。注册成功后最好去注册表里搜一下控件 CLSID，确认真的写进去了，别光看弹窗提示成功。
网页里怎么调用，参数别乱填
调用方式其实不复杂，在页面里用 object 标签引入，把 classid 写对，再给个 id 方便 JS 操作。真正麻烦的是参数配置，HTTP File Upload ActiveX 一般会有上传地址、最大文件大小、允许的扩展名、是否分块这些属性，每个项目封装的版本可能略有差别，一定要对着开发给的文档填，别照抄网上的老例子。
我习惯先把上传地址指向一个测试接口，传个小 txt 文件验证通路，通了再调大文件和批量上传。JS 这边调用上传方法后，记得监听进度和完成事件，不然用户点完按钮干等着，体验很差。还有编码问题，中文文件名在某些版本里会乱码，提前跟后端确认好编码格式。
常见报错，基本都是这几类
跑不起来的情况我总结了下，无非几种：一是安全级别太高，IE 把 ActiveX 拦了，得把站点加进受信任站点，再调低自定义级别里相关选项；二是控件没注册或者位数不对；三是杀毒软件把 dll 当风险文件隔离了，这个最隐蔽，去隔离区恢复并加白名单就行。
还有一种，页面能加载控件但上传失败，多半是服务器端跨域或者接口地址写错，跟 HTTP File Upload ActiveX 本身没关系，别一头扎进控件里查。建议打开浏览器控制台和抓包工具一起看，请求发没发出去一目了然。
现在还有必要学它吗
说实话，新项目真不建议再上 HTTP File Upload ActiveX 了，兼容性差、只认 IE 内核，维护成本高。但现实是老系统一堆，迁移不是说动就动，会调这个控件至少能让你在接手旧项目时不至于抓瞎。把它当成一项排障技能来掌握，心态就对了。
如果你只是想在新项目里做文件上传，直接上现代浏览器支持的方案更省心。真要维护老系统，把注册、调用、排错这三步走通，HTTP File Upload ActiveX 也没那么可怕。上面这些是我实际踩过的坑，照着排查能少走不少弯路。
喜欢 
高兴
鬼脸
呵呵
无聊
伤心
