Vue 3 で axios の POST が思ったとおりに動かない — リロードされる・2回飛ぶ・GETになる
先に結論
Vue で axios.post() を書いたのに思ったとおりに動かない、という話は3つに分かれます。
そして3つとも、原因は axios ではありません。
フォームの仕様と、HTTPのリダイレクトの仕様です。
| 症状 | 原因 | 直すところ |
|---|---|---|
| POSTするとページがリロードされる | フォームの既定動作が走っている | @submit.prevent(詳しく) |
| POSTが2回飛ぶ | button の click と form の submit が両方発火 | どちらか一方にする(詳しく) |
| POSTしたのにGETで届く | 途中に301か302のリダイレクトがある | URLを直す。308/307にする(詳しく) |
この3つは、同じ1行から出てきます。
<button @click="submit">送信</button>
<button> に type を書いていないことが、
症状1と症状2の両方の出どころです。手元のブラウザで確かめました。
| 書き方 | button.type の値 | form の submit |
|---|---|---|
<button>(type なし) | "submit" | 発火する |
<button type="button"> | "button" | 発火しない |
type を省略した <button> は、送信ボタンです。
ふつうのボタンのつもりで置くと、フォームの中では送信ボタンとして働きます。
プラグインを入れる時代は終わった
vue-axios はもう要らない
検索すると vue-axios や vue-resource を入れる手順が出てきます。
Vue 3 の Composition API では、どちらも不要です。
これらは「this.$http で呼べるようにする」ための薄いラッパでした。
this を使わない書き方では、意味がありません。
import axios from 'axios' と書けば、それで終わりです。
| 時代 | 書き方 | いま |
|---|---|---|
| jQuery | $.post(url, data) | — |
| Vue 1〜2 初期 | vue-resource を入れて this.$http.post() | 公式の推奨から外れた |
| Vue 2 | vue-axios を入れて this.$http.post() | Composition APIでは不要 |
| Vue 3 | import axios して axios.post() | これ |
| Vue 3(ライブラリなし) | fetch() | ブラウザ標準。追加なしで動く |
axios と fetch のどちらを使うか
fetch はブラウザに入っているので、依存を増やしたくないなら fetch で足ります。
axios を選ぶ理由は、主に手間の差です。
| 項目 | axios | fetch |
|---|---|---|
| インストール | 必要 | 不要 |
| JSONの送信 | オブジェクトを渡すだけ | JSON.stringify と Content-Type を自分で書く |
| JSONの受信 | res.data で取れる | await res.json() が要る |
| 4xx・5xx のとき | 例外になる | 例外にならない。res.ok を自分で見る |
| 共通設定(ベースURL・ヘッダ) | インスタンスで持てる | 自分でラッパを書く |
| タイムアウト | オプションで指定 | AbortSignal.timeout() を渡す |
4行目が一番の違いです。
fetch は404でも500でも例外を投げないので、
res.ok を見ないまま res.json() を呼んで、HTMLのエラーページをパースして落ちます。
そのときの読み方は Unexpected token '<' ... is not valid JSON の原因と直し方 に書きました。
症状1:POSTするとページがリロードされる
button に type を書いていない
axios.post() は走っているのに、直後にページが再読み込みされて結果が見えない、という症状です。
フォームの送信という既定動作が、別に走っています。
手元で確認したところ、submit ハンドラが呼ばれた時点で既定動作はまだ生きています。
| 確認したもの | 値 | 意味 |
|---|---|---|
ハンドラ内の event.defaultPrevented | false | 何もしなければフォームが送信される |
つまり、ハンドラの中で axios.post() を呼んでも、それとは別にブラウザがフォームを送ります。
action を書いていなくても、現在のURLに送られます。これがリロードの正体です。
直し方
Vue公式が用意しているのが .prevent 修飾子です。公式の説明はこうです。
「.prevent 修飾子は、イベントが発火した際に、
デフォルトのブラウザの動作(例: フォームの送信によるページのリロード)を防ぐために用いる」
— イベントハンドリング(Vue.js 公式・要約)
<form @submit.prevent="submit">
<input v-model="title">
<button>送信</button>
</form>
@click ではなく @submit.prevent に付けるのがポイントです。
こうすると、Enterキーでの送信も、ボタンのクリックも、同じ1か所を通ります。
公式が挙げている修飾子は次のとおりです。
| 修飾子 | 働き | この場面での使いどころ |
|---|---|---|
.prevent | 既定動作を止める | フォーム送信には必須 |
.once | 一度だけ発火する | 二重送信の抑止に使える(後述) |
.stop | 伝播を止める | 親のハンドラまで届かせたくないとき |
.self | その要素自身でのみ動く | 子要素からの発火を無視したいとき |
.capture | キャプチャ段階で捕まえる | この場面では使わない |
.passive | 既定動作を止めないと宣言する | .prevent と同時に使わない |
症状2:POSTが2回飛ぶ
実際に数えてみた
<form> の中に <button @click="submit"> を置き、
フォーム側にも submit のハンドラがある場合、どちらが何回呼ばれるのかを数えました。
| ボタンの書き方 | 発火したイベント | 回数 |
|---|---|---|
<button>(type なし) | button.click → form.submit | 2 |
<button type="button"> | button.click のみ | 1 |
順番も出ました。click が先で、submit が後です。
クリックが送信を引き起こしているので、この順になります。
ここで、@click と @submit の両方に POST を書いていると、2回飛びます。
ボタンは1回しか押していないのに、サーバーには2件登録されます。
これは画面上まったく見えません。 どちらの POST も成功するので、エラーも出ません。 データベースに同じレコードが2件ある、と気づいてから原因を探すことになります。 開発者ツールのNetworkタブで、1回の操作でリクエストが何本飛んでいるかを数えてください。
直し方
| やり方 | 書き方 | 評価 |
|---|---|---|
| フォームに寄せる | <form @submit.prevent="submit"> + <button>(ハンドラなし) | 推奨。Enterキーでも通る |
| ボタンに寄せる | <button type="button" @click="submit"> | 動くが、Enterキーで送信できない |
| 両方に書く | @submit.prevent + @click | 2回飛ぶ。やらない |
それとは別に、ユーザーが連打したときの二重送信も止めておきます。 これは原因が違う(イベントではなく操作)ので、対処も別です。
<script setup>
import { ref } from 'vue';
import axios from 'axios';
const sending = ref(false);
const title = ref('');
async function submit() {
if (sending.value) return; // 連打を弾く
sending.value = true;
try {
const res = await axios.post('/api/articles', { title: title.value });
// 成功時の処理
} finally {
sending.value = false; // 失敗しても必ず戻す
}
}
</script>
<template>
<form @submit.prevent="submit">
<input v-model="title">
<button :disabled="sending">
{{ sending ? '送信中…' : '送信' }}
</button>
</form>
</template>
finally で戻すのが要点です。
try の中で戻すと、エラーのときにボタンが押せないままになります。
症状3:POSTしたのにGETで届く
リダイレクトがメソッドを変える
axios.post() と書いているのに、サーバー側のログではGETになっている。
これはHTTPの仕様です。
MDNの記述を並べると、はっきりします。
| ステータス | POSTした場合 | MDNの記述(要約) |
|---|---|---|
| 301 Moved Permanently | GETに変わる | 「POSTリクエストに対して301を受け取った場合、続くリダイレクトリクエストではGETメソッドを使用します」 |
| 302 Found | GETに変わる | 「302をPOSTリクエストの返信として受け取った場合、以降のリダイレクトリクエストはGETメソッドを使用します」 |
| 307 Temporary Redirect | POSTのまま | 「元のリクエストのメソッドと本文は、リダイレクトされたリクエストを行う際に再利用されます」 |
| 308 Permanent Redirect | POSTのまま | 「リダイレクトされたリクエストでは、クライアントによってリクエストメソッドと本体が変更されることはありません」 |
MDNは対処も書いています。 301を使っていてメソッドを変えたくないなら308、302なら307に替えろ、という形です。
そしてGETに変わるとき、ボディも落ちます。 サーバー側では「GETで来たのにパラメータが無い」という見え方になります。
どこで起きているか
自分でリダイレクトを書いた覚えがなくても、サーバーやフレームワークが勝手に出しています。 よくある発生源はこれです。
| 原因 | 起きること | 直し方 |
|---|---|---|
| URLの末尾スラッシュ | /api/items → /api/items/ に301 | 正しい方のURLを最初から書く |
| http から https へ | 常時SSL化の301 | https:// で書く |
| www のあり・なし | 正規化の301 | 正規のホスト名で書く |
| 未ログインでログイン画面へ | 302でログイン画面に飛ぶ | APIは401をJSONで返す設計にする |
| フレームワークのルーティング | 別のパスへ302 | ルート定義を確認する |
一番多いのは末尾スラッシュです。 GETでは気づきません。リダイレクトされても結果が同じだからです。 POSTにしたときだけ壊れます。
確認は、Networkタブでリクエストが何本あるかを見るのが早いです。
301や302が1本挟まっていれば、それが原因です。
curl -i で叩いてステータス行を見ても分かります。
APIの認証切れでログイン画面に302で飛ばす設計は、 POSTがGETに化けるうえに、HTMLが返ってきてJSONのパースで落ちます。 APIは401をJSONで返すほうが、どちらの問題も消えます。 このあたりは WordPress REST API の認証を通す にも書きました。
いまの最小構成
3つの症状を全部避けた形です。
<script setup>
import { ref } from 'vue';
import axios from 'axios';
const title = ref('');
const sending = ref(false);
const error = ref('');
async function submit() {
if (sending.value) return;
sending.value = true;
error.value = '';
try {
const res = await axios.post(
'https://example.com/api/articles', // httpsで、末尾スラッシュも正しく
{ title: title.value }, // オブジェクトを渡すだけでJSONになる
{ timeout: 10000 }
);
title.value = '';
console.log(res.data);
} catch (e) {
if (e.response) {
error.value = `サーバーが ${e.response.status} を返しました`;
} else if (e.request) {
error.value = '応答がありません(通信かCORSの問題)';
} else {
error.value = `リクエストの組み立てに失敗: ${e.message}`;
}
} finally {
sending.value = false;
}
}
</script>
<template>
<form @submit.prevent="submit">
<input v-model="title" :disabled="sending">
<button :disabled="sending">送信</button>
<p v-if="error">{{ error }}</p>
</form>
</template>
<button> に @click を書いていないこと、
@submit.prevent が付いていることを確認してください。これで症状1と2が消えます。
CSRFトークンを付ける
バックエンドのフレームワークがCSRF対策をしていると、トークンを付けないと403で弾かれます。 付ける場所は、いまはヘッダが標準的です。
| フレームワーク | ヘッダ名 | トークンの置き場所 |
|---|---|---|
| Laravel | X-CSRF-TOKEN | <meta name="csrf-token"> |
| Rails | X-CSRF-Token | <meta name="csrf-token"> |
| Django | X-CSRFToken | csrftoken クッキー |
| WordPress REST API | X-WP-Nonce | wp_localize_script で渡す |
// 起動時に1回だけ、全リクエストに付ける
const token = document
.querySelector('meta[name="csrf-token"]')
?.getAttribute('content');
if (token) {
axios.defaults.headers.common['X-CSRF-TOKEN'] = token;
}
毎回の post() に書かないでください。
1か所に書き忘れただけで、そこだけ403になります。
axios.defaults か、インスタンスを作って interceptors で付けます。
トークンをリクエストのボディに入れる書き方は、いまは勧められません。 フレームワーク側がヘッダを見る前提になっていることが多く、 ボディに入れるとJSONの構造にトークンが混ざります。 ヘッダに入れてください。
エラーを切り分ける
axios のエラーは、3つのうちどれが入っているかで原因が分かれます。 公式ドキュメントがそう整理しています。
| 入っているもの | 意味 | 疑うところ |
|---|---|---|
error.response | サーバーが2xx以外で応答した | ステータスを見る。403ならCSRF、401なら認証、404ならURL |
error.request | リクエストは送ったが応答が無い | CORS・通信断・タイムアウト |
| どちらも無い | リクエストの組み立てで失敗した | URLやオプションの書き間違い |
2行目がCORSです。 ブラウザがレスポンスを読ませてくれないので、axios から見ると「応答が無い」に見えます。 コンソールにCORSの警告が出ていないか確認してください。 サーバー側のログにリクエストが届いているなら、通信は成功していて、ブラウザが結果を捨てています。
なお、POSTでCORSが絡むと、本番のリクエストの前にOPTIONSが飛びます(プリフライト)。 Networkタブで同じURLにOPTIONSとPOSTが並んでいたら、それは二重送信ではありません。
AIに任せるときの注意
| 頼むこと | 向くか | 理由 |
|---|---|---|
| 「Vue 3 の script setup で」と明示してフォーム送信を書かせる | 向く | 明示すれば vue-axios は出てこない |
| Networkタブのリクエスト一覧を貼って「2回飛ぶ原因は?」 | 向く | 301が挟まっているか、POSTが2本かを読み分けられる |
curl -i の出力を貼って「POSTがGETになる理由は?」 | 向く | ステータス行を見るだけ |
| 「Vue で ajax post する方法を教えて」 | 向かない | vue-axios や vue-resource が返る |
| 「POSTできません、直して」(情報なし) | 向かない | 原因が3種類ある。表1で先に絞る |
| リクエストが何本飛んでいるかの確認 | 向かない | Networkタブを自分で見る。ここは代われない |
判定は簡単です。出てきたコードに this.$http か Vue.use( があれば古いと思ってください。
import axios from 'axios' で始まっていれば現代のものです。
よくある質問
POSTすると画面がリロードされます
フォームの既定動作が止まっていません。@submit.prevent を付けてください(詳しく)。
<button> は type を省略すると送信ボタンになります(表2)。
同じデータが2件登録されます
@click と @submit の両方にPOSTを書いていませんか。
ボタンを1回押すと click → submit の順で両方発火します(表7)。
どちらか一方に寄せてください。
axios.post なのにサーバーにGETで届きます
途中に301か302のリダイレクトがあります。 MDNは「POSTに対して301/302を受け取った場合、以降はGETを使う」と書いています(表9)。 一番多いのは末尾スラッシュです。
vue-axios は入れたほうがいいですか
Vue 3 の Composition API では不要です。
this.$http を生やすためのラッパなので、this を使わない書き方では意味がありません(表3)。
axios と fetch はどちらがいいですか
依存を増やしたくないなら fetch で足ります。
ただし fetch は4xx・5xxで例外を投げません(表4)。
res.ok を自分で見る必要があります。
error に response が入っていません
リクエストは送られたが応答が無い状態です(表12)。 CORS・通信断・タイムアウトを疑ってください。 サーバーのログに届いているなら、ブラウザが結果を捨てています。
同じURLにOPTIONSとPOSTが並んでいます
CORSのプリフライトです。二重送信ではありません。 POSTが2本ある場合だけが二重送信です。
403が返ります
CSRFトークンが付いていない可能性が高いです(表11)。
毎回のPOSTに書くのではなく、axios.defaults で一括して付けてください。
Enterキーで送信できません
<button type="button"> にしていませんか。
フォーム送信に寄せる書き方(@submit.prevent)にすると、Enterキーでも通ります(表8)。
まとめ
- 3つの症状とも、原因は axios ではない。フォームの仕様とHTTPのリダイレクトの仕様。
<button>はtypeを省略すると送信ボタン。手元のChromeでtype === "submit"を確認した。- ボタンを1回押すと
click→submitの順で2つ発火する。両方にPOSTを書くと2回飛ぶ。 - 二重送信は画面に見えない。Networkタブで1操作あたりのリクエスト本数を数える。
- フォーム送信は
@submit.preventに寄せる。Enterキーでも通る。 - 連打対策は
sendingフラグ。finallyで戻す(tryの中だと失敗時に戻らない)。 - 301と302はPOSTをGETに変える。307と308は変えない。一番多い発生源は末尾スラッシュ。
vue-axiosもvue-resourceも不要。import axios from 'axios'で終わり。- CSRFトークンはヘッダに、
axios.defaultsで一括して付ける。 - エラーは
error.response/error.request/ どちらも無し の3つで切り分ける。requestだけならCORSを疑う。
同じ Vue 3 の話は Vue 3 でセレクトボックスからページ遷移する、 レスポンスがJSONでないときのエラーは Unexpected token '<' ... is not valid JSON の原因と直し方、 APIの認証は WordPress REST API の認証を通す、 SPAでの計測は GA4でSPAのページビューが計測されない5つの原因 に書きました。
<button> の既定値とイベントの発火順は、
2026年10月25日に Chrome 152 で実際にイベントを数えて確認したものです。
リダイレクトの挙動はMDNの記載、修飾子はVue公式の記載によります。
ブラウザやフレームワークのバージョンで変わることがあります。
本番に出す前に、Networkタブでリクエストの本数とメソッドを自分で確認してください。