Delphi项目可以继续承担桌面端业务,同时把文件存储、短信通知或后端接口放到阿里云上。对已有系统来说,通常不需要一次性重写:先挑一个边界清楚的功能接入,再逐步扩展。接口调用只是其中一环,密钥保护、超时处理和上线配置也要一起考虑。
下面以一个小型进销存系统为例,说明 Delphi 阿里云接入时常见的方案选择和注意事项。接口参数、鉴权方式和签名规则会因产品而异,实施时应核对所用服务的最新文档。
先确定Delphi与云服务各自负责什么
阿里云包含多种服务,Delphi应用常见的接入需求包括:将附件保存到对象存储OSS,通过短信服务发送验证码或业务提醒,在云服务器ECS上运行后端程序,或调用云上的自建业务接口。
- 直接调用云产品API:Delphi通过HTTPS访问接口,适合调用范围较小、鉴权方案清晰的功能。
- 调用自建后端:Delphi只连接企业自己的API,由后端访问云产品,适合权限规则较多、需要多端共用的业务。
- 使用OSS存文件:附件放在对象存储中,业务数据库保存对象名称或地址,避免把大量文件内容存进数据库。
旧系统可以分阶段改造。比如先迁移单据图片和扫描件,确认上传、查看、权限控制都稳定后,再接入短信或其他云端服务。这样出问题时,排查范围也比较明确。
案例:把进销存单据附件迁到OSS
假设一套Delphi进销存软件原来把扫描件放在办公室电脑的共享目录。外勤人员在外无法查看,存放文件的电脑出故障时,附件也可能受影响。改造后,程序把文件上传到阿里云OSS,并在单据记录中保存对象名称;用户查看单据时,再获取对应的访问地址。
先定文件规则和访问权限
动手接入前,列清楚附件类型、大小限制、保留时间和查看对象。合同、发票等资料通常不适合设置为公开读。可以让后端校验用户身份,再生成有时效的访问链接;如果访问控制要求更严格,也可以由后端代理下载,避免客户端直接接触存储权限。
还要考虑文件名和业务记录如何对应。建议保存稳定的对象标识,而不是只依赖本地路径;用户更换电脑后,本地路径往往不再有效。删除单据或更换附件时,也要明确OSS对象是否同步删除,避免数据库记录和存储文件逐渐对不上。
再选调用路径
Delphi可以直接通过HTTP调用OSS接口,也可以先把文件发给企业自己的后端,由后端完成鉴权和上传。直接调用少一层服务,但客户端需要处理签名、密钥保护和接口细节。经过后端中转,权限和操作记录更容易集中管理;长期维护的企业系统通常更适合这种方式,或使用后端签发的临时授权。
如果使用Delphi的HTTP组件,可以用TNetHTTPClient或项目中现有的HTTP库发送HTTPS请求。上传时设置请求方法、目标地址和必要请求头,并将文件流作为请求正文;下载时把响应写入本地文件流。OSS请求可能还要求日期、内容类型、哈希值和签名等信息,具体字段要按产品文档生成,不能只拼出URL就当作完成了鉴权。
HttpClient := TNetHTTPClient.Create(nil);
FileStream := TFileStream.Create(LocalFile, fmOpenRead or fmShareDenyWrite);
try
Response := HttpClient.Put(UploadUrl, FileStream, nil);
if (Response.StatusCode < 200) or (Response.StatusCode >= 300) then
raise Exception.Create('文件上传失败');
finally
FileStream.Free;
HttpClient.Free;
end;
这段代码只展示HTTP上传的基本结构,没有包含OSS签名、请求头和重试逻辑,不能直接作为完整的生产代码。接入时还应检查响应状态码和服务端返回内容,并确认文件流、HTTP客户端等资源在异常情况下也能正确释放。
不要把长期密钥放进桌面程序
Delphi桌面程序会分发到用户电脑。AccessKey如果写在程序、配置文件或注册表里,就有被提取和滥用的风险。较稳妥的做法是让后端持有密钥,客户端通过身份验证申请短时有效的上传授权,或者把文件发给后端,再由后端上传到OSS。
如果程序部署在云端并需要调用其他服务,应根据运行环境采用合适的角色授权方式,避免在代码中硬编码长期凭证。配置文件加密也不能代替权限控制:只要程序能读取密钥,就要考虑密钥被取出的可能。
接入短信服务时,签名和频率都要管
Delphi调用阿里云短信服务,同样需要处理账号权限、短信签名、模板、手机号格式、请求签名和发送频率。生产系统不宜让每台客户端都直接发短信。由后端统一检查业务条件、限制发送频率并记录请求结果,能减少接口被滥用,也便于排查请求已提交但用户没有收到短信的情况。
使用REST接口时,要留意UTF-8编码、HTTPS证书校验和URL参数编码。签名可能对参数顺序、编码方式和时间戳有明确要求,不能用普通字符串拼接替代规范实现。若使用SDK,先确认它是否适用于当前Delphi版本并能持续维护;没有可靠实现时,把短信调用封装在后端通常更省事。
ECS上的程序还需要上线配置
把Delphi编译出的服务程序复制到ECS,不代表部署已经完成。还要处理程序如何启动和重启、日志写到哪里、数据库连接如何配置,以及域名和HTTPS证书是否可用。安全组只开放业务需要的端口;远程桌面等管理入口应限制来源IP,并启用强密码和多因素认证。
上线前用测试环境验证断网、请求超时、重复提交和服务重启等情况。云端接口可能短时不可用,客户端应设置合理的连接与读取超时。只有在请求可以安全重试时,才进行有限次数的重试;下单或发短信等操作要设计好重复请求的处理方式,避免产生重复订单或重复通知。
日志可以记录请求编号、业务编号、响应状态和错误摘要,便于把客户端操作与服务端记录对应起来。不要把AccessKey、完整敏感资料或用户隐私写入日志。排查问题时,留下必要线索即可。
从一个业务场景开始接入
Delphi接入阿里云,发出HTTP请求并不难,麻烦通常出现在密钥如何保管、权限如何校验、失败后怎样处理,以及业务记录和云端文件如何保持一致。可以先封装一层统一的云服务访问代码,把调用逻辑与界面分开,再按需求接入OSS、短信或ECS上的业务接口。
例如,先在测试环境完成附件上传、访问权限、异常重试和日志验证,再开放给实际用户。这样既能控制改造范围,也方便定位问题;后续更换鉴权方式或调整云服务时,不必把相关逻辑散落在各个窗体中逐处修改。