文永之役，即第一次元日战争，发生于日本文永十一年、元朝至元十一年(1274年)，当时日本后宇多天皇的年号为"文永"，称"文永之役"，此役元军以失败收场。
1271年十一月，忽必烈正式称帝，建立大元帝国，一方面以摧枯拉朽之势攻打南宋，一方面也做好了渡海侵略日本的准备。到了文永十一年〔1274年〕，忽必烈在朝鲜建立征东行省，征发高丽船工、民夫三万五千人，建造了九百艘大战舰。当年十月，他以忻都为都元帅，洪荼丘、刘复亨为左右元帅，率领大军四万，从朝鲜的合浦出发，浩浩荡荡远征日本。
经过
至元十一年(1274年)六月，元世祖忽必烈委托高丽造大小舰900艘。八月，忽必烈任命忻都为征东都元帅、洪茶丘为右副帅、刘复亨为左副帅，统帅蒙古军 汉军2万人、高丽军5600人，加上高丽水手6700人，(蒙古人为核心，南人最多，打头阵)共3万2千300人，远征日本。
元十一年十月三日，元军从高丽合浦(今镇海湾马山浦附近)出发，六日成功登陆对马岛，全歼岛上日守军。十四日傍晚，元军400余人登陆壹岐岛，守护代宗助国父子率领八十骑拦阻，被全歼，元军立赤旗为标记。守军左卫门尉平经高(平内左卫门景隆)率百余骑与元军激战。元军采用密集战术，与"铁炮"(石火矢)等武器，日军不敌，退守城内。次日城破，平经高自杀。元军准备到博多湾登陆，在逼近肥前沿海岛屿时，遭到肥前守护松浦一族(松浦党)的英勇抗击，双方有一番激战，松浦一族死伤惨重。
元十一年十月十九日，元军成功登陆博多湾(今福冈附近)，进逼今津，此带地形不利于大部队展开，距大宰府有一日行程，元军于当晚又撤回到船上，准备次日清晨重新登陆发动进攻。二十日晨(11月26日)，元军分二路在博多湾登陆。日本幕府聚集少贰资景、大友赖泰、菊池武房、岛津久经、竹崎季长等的九州诸国部队总数约十万大军。元军西路军在百道原登陆，藤原经资率500骑前来迎战元军，东路军在博多湾东部的博多箱崎成功登陆，击败守军，占领岸边松林，从背后突袭在百道原同元军作战的日军。日军腹背受敌，死伤惨重，余部向太宰府水城(前代建筑的一座巨大水坝)方向撤退。此时天色已晚，副帅刘复亨中箭受伤，元军停止进攻。当晚，元军召开军事会议，由于后援不足，多数将领主张撤退。于是忻都下令撤退，撤退当晚竟遭到台风侵袭，"会夜大风雨，战舰触岩崖多败"，二十一日晨海面上只剩下一些破碎的木片，元军损失1.3万余人，大多死于这场风暴。最后辗转回到中国的只剩下1万3千500人。
