1. 原因分析
1.1 数据字段映射错误
在 Odoo 15 的送货单处理中，送货地址通常依赖于销售订单的运送地址字段。partner_shipping_id 是核心字段，用于保存客户的运送地址信息。如果此字段未正确填充、被覆盖或者被自定义模块修改，显示的送货地址就可能不准确，甚至指向错误的地点。表现为地址字段缺失、街道错位、城市或邮编错乱等现象，这就是 Odoo 15 送货单地址显示错误的常见根本原因之一。字段映射正确性直接决定了前端显示的地址信息。
此外，若同一个送货单记录在不同阶段被多次修改，字段覆盖顺序发生变化，也容易导致地址显示错乱。例如，一次来自销售订单的地址被写入，随后又被订单改动或后续自定义逻辑覆盖，最终呈现的地址可能与实际运送信息不一致。这些变动都需要重点关注以定位问题根源。
# 诊断：读取送货单的地址字段
picking = env['stock.picking'].browse(picking_id)
addr_shipping = getattr(picking, 'partner_shipping_id', None)
print('shipping_id:', addr_shipping.id if addr_shipping else '空')
print('shipping street:', addr_shipping.street if addr_shipping else '空')
1.2 模板字段取值异常
除了字段本身的值，显示地址的模板渲染也会影响最终呈现。若 Odoo 的 QWeb 模板在渲染时错误地使用了 record.partner_id 等非运送地址字段，或者对地址字段的组合逻辑写错，都会导致“显示的地址与实际地址不符”的情况出现。这在升级、迁移或二次开发后尤为常见。
自定义模块若修改了 XML 视图或 QWeb 模板的渲染路径，若未同步更新字段名、字段来源，亦会触发 地址渲染异常。对照官方模板与自定义模板，逐字段对齐是排查要点之一。
,
1.3 版本升级后的字段迁移问题
在 Odoo 15 的版本升级或字段迁移过程中，某些地址字段的名字、结构或关联关系可能发生变动。如果迁移脚本未覆盖到涉及送货地址的字段，旧有的数据会与新版本的字段约束不匹配，导致地址显示异常。此类问题在数据库层面易于被忽略，但会在前端呈现阶段暴露出来，成为 送货单地址显示错误 的潜在原因。
-- 简单检查迁移后地址字段的一致性示例
SELECT sp.id, sp.partner_shipping_id, rp.id AS ship_addr_id
FROM stock_picking AS sp
LEFT JOIN res_partner AS rp ON sp.partner_shipping_id = rp.id
WHERE sp.partner_shipping_id IS NULL;
2. 排查要点
2.1 数据层排查要点
第一步聚焦于数据库与模型之间的映射关系，确认送货单的地址字段来源是否为正确的运送地址字段。重点检查点包括 stock.picking.partner_shipping_id、sale.order.partner_shipping_id 与 res.partner 的地址字段是否一致、是否被覆盖、以及是否存在空值导致的回退显示。
使用日志和调试工具可以帮助定位：记录来源、字段赋值流程、以及是否存在字段空值或错误值的情况。若在数据库层面发现地址字段为空，应追溯到销售订单与送货单之间的传递链路。
-- 检查送货单是否存在没有地址的情况
SELECT sp.id, sp.origin, sp.partner_shipping_id
FROM stock_picking sp
WHERE sp.partner_shipping_id IS NULL;
2.2 视图与模板排查
若数据本身没有问题，下一步应聚焦 视图和模板 的实现是否正确渲染地址信息。检查是否有自定义模块修改了模板路径、字段名，或将地址字段渲染成了错误的组合。模板路径一致性和 字段来源是关键点。
建议逐步对比官方模板与自定义模板，必要时使用临时的占位渲染来确认地址字段是否来自正确的模型字段。
2.3 前端缓存与部署排查
地址显示问题也可能与前端缓存、浏览器缓存、以及服务器端的模块加载顺序有关。确保在修改模板后对相关模块进行完整升级与重启，清除浏览器缓存，避免旧版本的模板残留影响显示结果。
# 常见部署排查命令（示例）
sudo systemctl restart odoo
./odoo-bin -d your_db -u your_module --stop-after-init
3. 快速解决方案
3.1 数据层修复步骤
快速修复思路是确保送货单的地址字段被正确赋值并传递到前端显示。核心动作包括确保销售订单的运送地址字段能正确传递到送货单，并在必要时进行一次性修复性写入。确保 partner_shipping_id 已填充，并且与销售订单的一致性得到保持。
可执行的快速修复示例：将销售订单的运送地址填充到送货单中，确保显示地址来源正确。
# 快速将销售订单的运送地址赋给送货单
picking = env['stock.picking'].browse(picking_id)
sale = env['sale.order'].browse(picking.origin) # 依据 origin 对应需求调整
if sale and sale.partner_shipping_id:picking.partner_shipping_id = sale.partner_shipping_idpicking.write({'partner_shipping_id': sale.partner_shipping_id.id})
3.2 代码与视图修复
若模板渲染路径存在问题，需对模板进行修复，确保地址字段来自正确的运送地址对象。以下示例展示了修复后的模板要点：地址信息优先使用运送地址字段，回退逻辑更清晰。
,
3.3 部署与缓存清理步骤
修改完成后，务必进行模块升级、服务重启以及前端缓存清理，以确保新逻辑被正确加载。标准流程包括模块升级、服务重启以及前端缓存刷新。
# 部署与缓存清理步骤（示例）
sudo systemctl restart odoo
./odoo-bin -d your_db -u your_module --stop-after-init
# 清理浏览器缓存或强制刷新
